Content
<p align="center">
<h1 align="center">⚖️ Matsne.gov.ge MCP Server</h1>
<p align="center">
<strong>Search, read and analyze Georgia's official legislative database — through AI</strong><br>
<em></em>
</p>
<p align="center">
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"></a>
<img src="https://img.shields.io/badge/Python-3.10+-brightgreen" alt="Python 3.10+">
<img src="https://img.shields.io/badge/MCP-1.0+-purple" alt="MCP 1.0+">
</p>
</p>
<p align="center"><strong><code>🇬🇪 Made with love from Batumi, Georgia</code></strong></p>
---
## ✨ One-click setup — copy this to Claude
> **Non-technical?** Just copy the box below, paste it to Claude or any AI assistant, and it will set up everything for you — download, install, configure, and test.
<pre>
I want to use the Matsne.gov.ge MCP server from https://github.com/sitechfromgeorgia/matsne-gov-ge-mcp
Please help me set it up. Here's what I need you to do:
1. Check if Python 3.10+ is installed — if not, tell me to download it from https://www.python.org/downloads/
2. Check if `uv` is installed — if not:
- Windows (PowerShell): `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"`
- Mac/Linux: `curl -LsSf https://astral.sh/uv/install.sh | sh`
3. Download the project:
- If git is installed: `git clone https://github.com/sitechfromgeorgia/matsne-gov-ge-mcp`
- Otherwise: download the ZIP from the GitHub page and extract it
4. Navigate to the project folder and run: `uv run mcp_server.py`
5. Tell me the full folder path so I can configure Claude Desktop
6. Tell me to:
- Open Claude Desktop → Settings → Developer → Edit Config
- Add this (replace PATH with my actual folder path):
```json
{
"mcpServers": {
"matsne-ge": {
"command": "uv",
"args": ["--directory", "PATH", "run", "mcp_server.py"]
}
}
}
```
7. Restart Claude Desktop and verify the 🔧 icon appears
Please walk me through each step and check as we go.
</pre>
---
## English
### What is this?
An **MCP server** that connects AI assistants to [matsne.gov.ge](https://matsne.gov.ge) — Georgia's official legislative database. Search, read, and analyze Georgian laws through natural conversation.
### Tools
| Tool | Purpose |
|---|---|
| `matsne_suggest` | Fast keyword autocomplete |
| `matsne_search` | Filtered search (date, type, organ, pagination) |
| `matsne_get_document` | Full document: meta + text + tree + comments |
| `matsne_get_tree` | Document structure (articles, chapters) |
| `matsne_get_back_references` | Citing documents |
| `matsne_get_comments` | User comments |
| `matsne_get_linked` | Specific article text |
| `matsne_search_by_keyword` | Active documents by keyword |
| `matsne_has_today` | Check today's publications |
| `matsne_today_documents` | Today's documents |
### Quick install
```sh
pip install uv # or install from https://docs.astral.sh/uv/
git clone https://github.com/sitechfromgeorgia/matsne-gov-ge-mcp
cd matsne-gov-ge-mcp
uv run mcp_server.py
```
Then add to Claude Desktop:
```json
{
"mcpServers": {
"matsne-ge": {
"command": "uv",
"args": ["--directory", "/path/to/matsne-gov-ge-mcp", "run", "mcp_server.py"]
}
}
}
```
### Example prompts
- _"Search for today's published documents on matsne.gov.ge"_
- _"Find laws about personal data published in the last month"_
- _"Get full information on document #6840140 and summarize it"_
---
## 📄 License
[MIT](LICENSE) — use freely, share, improve.
---
<p align="center">
<strong><code>🇬🇪 Made with love from Batumi, Georgia</code></strong><br>
<br>
<sub>If this tool helps you, star it on GitHub ⭐ — it means a lot to a small dev from Batumi</sub>
</p>
