内容
# VosDroits MCP 服务器
一个提供法国公共服务和税务信息搜索及检索功能的模型上下文协议（MCP）服务器，信息来源于service-public.gouv.fr 和 impots.gouv.fr。
## 描述
该MCP服务器使AI助手能够搜索和检索官方的法国行政程序和税务信息。服务器使用Go语言构建，并通过智能网页抓取技术提供八种主要功能：
### Service-Public.gouv.fr 工具
- **搜索程序**：查找相关的公共服务程序和文章
- **获取文章**：从特定的service-public.gouv.fr文章中检索完整信息
- **列出类别**：浏览可用的公共服务信息类别
- **列出人生事件**：列出所有可用的人生事件（événements de vie）指南
- **获取人生事件详情**：检索特定人生事件的详细信息
### Impots.gouv.fr 工具
- **搜索税务**：在impots.gouv.fr上搜索税务表格、文章和程序
- **获取税务文章**：从特定的税务文章或表格中检索详细信息
- **列出税务类别**：列出可用的税务服务类别
## 安装
### 下载预编译二进制文件
从 [Releases 页面](https://github.com/guigui42/mcp-vosdroits/releases) 为您的平台下载最新的发布版本。
支持的平台：
- **Linux**：amd64, arm64
- **macOS**：amd64（Intel），arm64（Apple Silicon）
- **Windows**：amd64
```bash
# 示例：下载并运行Linux二进制文件
curl -LO https://github.com/guigui42/mcp-vosdroits/releases/latest/download/mcp-vosdroits-linux-amd64
chmod +x mcp-vosdroits-linux-amd64
./mcp-vosdroits-linux-amd64
```
所有二进制文件都包含SHA256校验和用于验证。
### 使用Docker（推荐）
从GitHub容器注册表中拉取并运行官方镜像：
```bash
docker pull ghcr.io/guigui42/mcp-vosdroits:latest
docker run -i ghcr.io/guigui42/mcp-vosdroits:latest
```
### 在VSCode中使用GitHub Copilot
要在VSCode中使用GitHub Copilot的MCP服务器，您需要在MCP设置中配置它。有关详细信息，请参阅 [VSCode MCP文档](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)。
#### 一键安装：
[](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522vosdroits%2522%252C%2522command%2522%253A%2522docker%2522%252C%2522args%2522%253A%255B%2522run%2522%252C%2522-i%2522%252C%2522--rm%2522%252C%2522ghcr.io%252Fguigui42%252Fmcp-vosdroits%253Alatest%2522%255D%257D) [](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522vosdroits%2522%252C%2522command%2522%253A%2522docker%2522%252C%2522args%2522%253A%255B%2522run%2522%252C%2522-i%2522%252C%2522--rm%2522%252C%2522ghcr.io%252Fguigui42%252Fmcp-vosdroits%253Alatest%2522%255D%257D)
#### 手动安装：
遵循 [MCP安装指南](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)，并使用下面的标准配置。将配置添加到您的MCP设置文件（通常是 `~/Library/Application Support/Code/User/mcp.json` 在macOS上）。
**使用Docker镜像（推荐）：**
```json
{
"servers": {
"vosdroits": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/guigui42/mcp-vosdroits:latest"
]
}
}
}
```
**使用本地二进制文件：
如果您从源代码构建了服务器：
```json
{
"servers": {
"vosdroits": {
"command": "/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits"
}
}
}
```
**使用环境变量：
配置自定义环境变量用于日志记录和超时：
```json
{
"servers": {
"vosdroits": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "LOG_LEVEL=debug",
"-e", "HTTP_TIMEOUT=60s",
"ghcr.io/guigui42/mcp-vosdroits:latest"
]
}
}
}
```
添加配置后，重启VSCode或重新加载窗口。服务器将在GitHub Copilot聊天中可用，您可以使用可用的工具查询法国公共服务信息。
### GitHub Copilot CLI
要在GitHub Copilot CLI中使用此MCP服务器，请将配置添加到您的MCP设置文件（`~/.copilot/mcp-config.json`）。
**使用Docker镜像（推荐）：**
```json
{
"mcpServers": {
"vosdroits": {
"type": "local",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/guigui42/mcp-vosdroits:latest"
],
"tools": [
"*"
]
}
}
}
```
**使用本地二进制文件：
如果您从源代码构建了服务器：
```json
{
"mcpServers": {
"vosdroits": {
"type": "local",
"command": "/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits",
"args": [],
"tools": [
"*"
]
}
}
}
```
**使用环境变量：
配置自定义环境变量用于日志记录和超时：
```json
{
"mcpServers": {
"vosdroits": {
"type": "local",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/guigui42/mcp-vosdroits:latest"
],
"env": {
"LOG_LEVEL": "debug",
"HTTP_TIMEOUT": "60s"
},
"tools": [
"*"
]
}
}
}
```
添加配置后，重启您的终端或运行 `gh copilot reload` 以加载新的MCP服务器。
### Claude 桌面版
要在Claude桌面版中使用此MCP服务器，请将配置添加到您的MCP设置文件：
- **macOS**：`~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**：`%APPDATA%\Claude\claude_desktop_config.json`
**使用Docker镜像（推荐）：**
```json
{
"mcpServers": {
"vosdroits": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/guigui42/mcp-vosdroits:latest"
]
}
}
}
```
**使用本地二进制文件：
如果您从源代码构建了服务器：
```json
{
"mcpServers": {
"vosdroits": {
"command": "/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits",
"args": []
}
}
}
```
**使用环境变量：
配置自定义环境变量用于日志记录和超时：
```json
{
"mcpServers": {
"vosdroits": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "LOG_LEVEL=debug",
"-e", "HTTP_TIMEOUT=60s",
"ghcr.io/guigui42/mcp-vosdroits:latest"
]
}
}
}
```
添加配置后，重启Claude桌面版。服务器将可用，您可以使用可用的工具查询法国公共服务和税务信息。
## 可用工具
服务器跨两个领域提供八种MCP工具：
### 应使用哪个工具？
**适用于重大人生事件** （购买房屋、结婚、生孩子、死亡、搬家、退休等）：
- 🎯 **从 `列出人生事件`** 开始 - 按主题组织的综合指南
- 然后使用 **`获取人生事件详情`** 以及URL以获取所有程序
**适用于特定行政程序** （护照续期、驾驶执照等）：
- 🔍 **使用 `搜索程序`** - 针对特定程序的目标搜索
- 然后使用 **`获取文章`** 以获取完整详情
**适用于税务信息**：
- 💰 **使用 `搜索税务`** 获取表格和税务程序
- 然后使用 **`获取税务文章`** 获取详细信息
### Service-Public.gouv.fr 工具
#### 1. 搜索程序
在service-public.gouv.fr上搜索程序。
**输入：**
- `查询` （字符串）：程序的搜索查询
- `限制` （整数，可选）：返回结果的最大数量（1-100，默认：10）
**输出：**
- `结果`：具有标题、URL和描述的匹配程序数组
#### 2. 获取文章
从service-public.gouv.fr上的特定文章URL检索详细信息。
**输入：**
- `URL` （字符串）：要检索的文章的URL
**输出：**
- `标题`：文章标题
- `内容`：完整文章内容
- `URL`：文章URL
#### 3. 列出类别
列出可用的公共服务信息类别。
**输出：**
- `类别`：具有名称和描述的可用类别数组
#### 4. 列出人生事件
列出service-public.gouv.fr的“Comment faire si”部分的所有可用人生事件。从诸如期待孩子、搬家、退休等重大人生事件的综合实用指南。
**输出：**
- `事件`：具有标题、URL和描述的人生事件数组
**示例事件：**
- “我期待一个孩子”
- “我搬到法国”
- “亲人去世”
- “我准备退休”
#### 5. 获取人生事件详情
检索特定人生事件的详细信息，包括按主题（健康、民事状态、就业等）组织的章节。
**输入：**
- `URL` （字符串）：要检索的人生事件的URL（从 `列出人生事件` 结果）
**输出：**
- `标题`：人生事件标题
- `URL`：人生事件URL
- `介绍`：概述文本
- `章节`：具有标题和内容的详细章节数组
**参见：** [人生事件文档](docs/LIFE_EVENTS.md)
### Impots.gouv.fr 工具
#### 4. 搜索税务
在impots.gouv.fr上搜索税务表格、文章和程序。
**输入：**
- `查询` （字符串）：税务信息和表格的搜索查询（例如“formulaire 2042”，“PEA”）
- `限制` （整数，可选）：返回结果的最大数量（1-100，默认：10）
**输出：**
- `结果`：具有标题、URL、描述、类型和日期的匹配税务文档数组
**示例查询：**
- “formulaire 2042” - 查找所得税申报表
- “PEA” - 查找股权储蓄计划信息
- “crédit d'impôt” - 查找税收抵免信息
#### 5. 获取税务文章
从impots.gouv.fr上的特定税务文章或表格URL检索详细信息。
**输入：**
- `URL` （字符串）：要检索的税务文章或表格的URL
**输出：**
- `标题`：文档标题
- `内容`：完整文档内容
- `URL`：文档URL
- `类型`：文档类型（Formulaire、Article等）
- `描述`：简要描述
#### 6. 列出税务类别
列出impots.gouv.fr上的可用税务信息类别。
**输出：**
- `类别`：具有名称、描述和URL的税务类别数组（Particulier、Professionnel、Partenaire、Collectivité、International）
## 截图
<img width="1633" height="1292" alt="20251021212600" src="https://github.com/user-attachments/assets/12eb095f-37e6-4b18-89ad-767f1bf558a5" />
## 文档
面向开发者和贡献者：
- [开发指南](docs/DEVELOPMENT.md) - 本地开发、测试和贡献指南
- [发布流程](docs/RELEASE.md) - 发布流程和自动化说明
- [网页抓取实现](docs/SCRAPING.md) - service-public.gouv.fr网页抓取技术细节
- [Colly集成指南](docs/COLLY_INTEGRATION.md) - 网页抓取框架文档
## 许可证
MIT许可证 - 有关详细信息，请参见LICENSE文件。
连接信息
猜你喜欢
暂无推荐服务器