内容
<p align="center">
<h1 align="center">⚖️ Matsne.gov.ge MCP 服务器</h1>
<p align="center">
<strong>搜索、阅读和分析格鲁吉亚官方立法数据库 — 通过人工智能</strong><br>
<em>საქართველოს საკანონმდებლო მაცნე — ნებისმიერი AI ასისტენტიდან</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>
---
## ✨ 一键设置 — 复制到 Claude
> **非技术人员？** 只需复制下面的内容，粘贴到 Claude 或任何 AI 助手，它将为您设置一切 — 下载、安装、配置和测试。
<pre>
我想要使用来自 https://github.com/sitechfromgeorgia/matsne-gov-ge-mcp 的 Matsne.gov.ge MCP 服务器
请帮助我设置它。以下是您需要做的：
1. 检查是否安装了 Python 3.10+ — 如果没有，请从 https://www.python.org/downloads/ 下载
2. 检查 `uv` 是否安装 — 如果没有：
- Windows（PowerShell）：`powershell -c "irm https://astral.sh/uv/install.ps1 | iex"`
- Mac/Linux：`curl -LsSf https://astral.sh/uv/install.sh | sh`
3. 下载项目：
- 如果安装了 git：`git clone https://github.com/sitechfromgeorgia/matsne-gov-ge-mcp`
- 否则：从 GitHub 页面下载 ZIP 并解压
4. 导航到项目文件夹并运行：`uv run mcp_server.py`
5. 告诉我完整的目录路径，以便我可以配置 Claude Desktop
6. 告诉我：
- 打开 Claude Desktop → 设置 → 开发者 → 编辑配置
- 添加以下内容（替换 PATH 为您的实际目录路径）：
```json
{
"mcpServers": {
"matsne-ge": {
"command": "uv",
"args": ["--directory", "PATH", "run", "mcp_server.py"]
}
}
}
```
7. 重启 Claude Desktop 并验证 🔧 图标是否出现
请逐步指导我并在过程中检查。
</pre>
---
## 🇬🇪 ქართული
### 什么是它？
这是一个 **MCP（模型上下文协议）服务器**，它允许任何 AI 助手（Claude Desktop、VS Code、Cursor、Windsurf）**搜索、阅读和分析** 来自 [matsne.gov.ge](https://matsne.gov.ge) 的文档 — 格鲁吉亚官方立法数据库。
**What?** 一个连接 AI 助手到格鲁吉亚官方立法数据库的 MCP 服务器。
**为什么？** 为了让 AI 可以实时搜索、阅读和分析格鲁吉亚立法 — 简单、自然的语言。
### 🛠️ 可用工具
| 工具 | 功能 |
|---|---|
| `matsne_suggest` | 关键词快速自动补全 |
| `matsne_search` | 筛选搜索（日期、类型、机构、编号） |
| `matsne_get_document` | 文档：元数据 + 正文 + 结构 + 评论 |
| `matsne_get_tree` | 文档结构（章节、条款） |
| `matsne_get_back_references` | 引用该文档的文档 |
| `matsne_get_comments` | 用户评论 |
| `matsne_get_linked` | 特定条款的文本 |
| `matsne_search_by_keyword` | 按关键词搜索生效文档 |
| `matsne_has_today` | 检查今日发布文档 |
| `matsne_today_documents` | 今日发布的文档 |
### 📖 安装
#### 1. Python 安装
👉 [python.org/downloads](https://www.python.org/downloads/) — 下载并安装。**在 Windows 上勾选“将 Python 添加到 PATH”**。
#### 2. uv 安装
**Windows — 在 PowerShell 中输入：**
```powershell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
**Mac/Linux:**
```sh
curl -LsSf https://astral.sh/uv/install.sh | sh
```
> **安装后重启终端。**
#### 3. 下载项目
**使用 Git：**
```sh
git clone https://github.com/sitechfromgeorgia/matsne-gov-ge-mcp
cd matsne-gov-ge-mcp
```
**使用 ZIP：** GitHub 上 → `Code` → `Download ZIP` → 解压
#### 4. 启动 MCP 服务器
```sh
uv run mcp_server.py
```
> **看不到任何内容？** 这是正常的 — 服务器在后台运行。按 `Ctrl+C` 退出。
#### 5. 连接到 Claude Desktop
**Claude Desktop** → 设置 → 开发者 → 编辑配置 → 粘贴：
```json
{
"mcpServers": {
"matsne-ge": {
"command": "uv",
"args": ["--directory", "C:\\Users\\您的用户名\\matsne-gov-ge-mcp", "run", "mcp_server.py"]
}
}
}
```
> **重要：** `C:\\Users\\您的用户名\\...` — 替换为您下载项目的实际路径。
**重启 Claude Desktop。** 如果 🔧 显示出来 — 准备好了 🎉
### 💬 示例指令
尝试这些请求：
- _"搜索今日发布的文档"_
- _"查找近 30 天内发布的劳动法相关法律"_
- _"文档 6840140 中写了什么？分析它"_
- _"谁发布了 6840140，什么时候发布，属于哪种类型？"_
- _"搜索包含 '个人信息' 的生效法律列表"_
- _"检查今天发布了哪些法律"_
### ⚠️ 故障排除
| 问题 | 解决方案 |
|---|---|
| "uv is not recognized" | uv 未安装，请检查步骤 2 |
| "Python not found" | Python 未安装，或未勾选“添加到 PATH” |
| "No module named mcp" | 运行 `uv run mcp_server.py`（不是 `python mcp_server.py`） |
| 🔧 在 Claude 中不显示 | 检查 JSON 配置文件中的路径 |
| "Access Denied" | API 端点正在工作 — 主要功能可用 |
---
## 📄 许可证
[MIT](LICENSE) — 免费使用、分享、改进。
---
<p align="center">
<strong><code>🇬🇪 由爱心在格鲁吉亚巴统创建</code></strong><br>
<strong><code>🇬🇪 Made with love from Batumi, Georgia</code></strong><br>
<br>
<sub>如果此工具对您有帮助，请在 GitHub 上点赞 ⭐ — 这对来自巴统的小开发者意义重大</sub>
</p>
