VosDroits MCP服务器
一种模型上下文协议（MCP）服务器，为法国公共服务和税收信息提供搜索和检索功能，这些信息来自service-public.gouv.fr和impots.gouv.fr。
描述
此MCP服务器使AI助手能够搜索和检索法国官方行政程序和税务信息。它采用Go语言构建，并由智能网络抓取提供支持，提供了八种主要功能：
服务-公共.gouv.fr工具
- 搜索程序：查找相关公共服务程序和文章
- 获取_文章：从特定服务中检索完整信息-public.gouv.fr文章
- 列表_类别：浏览公共服务信息的可用类别
- list_life事件：列出所有可用的生活事件指南
- get_life-event_details：检索有关特定生活情况的详细信息
Impots.gouv.fr工具
- search_impots：在impots.gouv.fr上搜索税务表格、文章和程序
- get_impots_article：从特定税务文章或表格中检索详细信息
- 列表_项目_类别：列出可用的税务服务类别
安装
下载预构建的二进制文件
从以下网址下载适用于您平台的最新版本 发布页面.
可用平台：
- Linux：amd64、arm64
- macOS：amd64（英特尔）、arm64（苹果硅）
- 视窗：amd64
BASH``` 1 2 3 4# Example: Download and run Linux binary 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```
1
2docker pull ghcr.io/guigui42/mcp-vosdroits:latest
docker run -i ghcr.io/guigui42/mcp-vosdroits:latestVSCode与GitHub Copilot
要在VSCode中将此MCP服务器与GitHub Copilot一起使用，您需要在MCP设置中对其进行配置。看 VSCode MCP文档 了解详细信息。
一键安装：
手动安装：
跟随 MCP安装指南，并使用下面的标准配置。应将配置添加到MCP设置文件中（通常 ~/Library/Application Support/Code/User/mcp.json 在macOS上）。
使用Docker镜像（推荐）：
JSON``` 1 2 3 4 5 6 7 8 9 10 11 12 13{ “servers”: { “vosdroits”: { “command”: “docker”, “args”: [ “run”, “-i”, “—rm”, “ghcr.io/guigui42/mcp-vosdroits:latest” ] } } }
**使用本地二进制：**
如果您从源代码构建了服务器：
JSON```
1
2
3
4
5
6
7{
"servers": {
"vosdroits": {
"command": "/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits"
}
}
}使用环境变量：
为日志记录和超时配置自定义环境变量：
JSON``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15{ “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 Chat中可用，您可以使用可用的工具查询法国公共服务信息。
### GitHub Copilot命令行界面
要将此MCP服务器与GitHub Copilot CLI一起使用，请将配置添加到MCP设置文件中(`~/.copilot/mcp-config.json`).
**使用Docker镜像（推荐）：**
JSON```
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17{
"mcpServers": {
"vosdroits": {
"type": "local",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/guigui42/mcp-vosdroits:latest"
],
"tools": [
"*"
]
}
}
}使用本地二进制：
如果您从源代码构建了服务器：
JSON``` 1 2 3 4 5 6 7 8 9 10 11 12{ “mcpServers”: { “vosdroits”: { “type”: “local”, “command”: “/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits”, “args”: [], “tools”: [ ”*” ] } } }
**使用环境变量：**
为日志记录和超时配置自定义环境变量：
JSON```
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21{
"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桌面版
要将此MCP服务器与Claude Desktop一起使用，请将配置添加到MCP设置文件中：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
使用Docker镜像（推荐）：
JSON``` 1 2 3 4 5 6 7 8 9 10 11 12 13{ “mcpServers”: { “vosdroits”: { “command”: “docker”, “args”: [ “run”, “-i”, “—rm”, “ghcr.io/guigui42/mcp-vosdroits:latest” ] } } }
**使用本地二进制：**
如果您从源代码构建了服务器：
JSON```
1
2
3
4
5
6
7
8{
"mcpServers": {
"vosdroits": {
"command": "/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits",
"args": []
}
}
}使用环境变量：
为日志记录和超时配置自定义环境变量：
JSON``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15{ “mcpServers”: { “vosdroits”: { “command”: “docker”, “args”: [ “run”, “-i”, “—rm”, “-e”, “LOG_LEVEL=debug”, “-e”, “HTTP_TIMEOUT=60s”, “ghcr.io/guigui42/mcp-vosdroits:latest” ] } } }
添加配置后，重新启动Claude Desktop。服务器将可用，您可以使用可用的工具查询法国公共服务和税务信息。
## 可用工具
服务器跨两个域提供八个MCP工具：
### 我应该使用哪种工具？
**适用于重大生活情况** （买房、结婚、生孩子、死亡、搬家、退休等）：
- 🎯 **从开始 `list_life_events`** -按主题组织的综合指南
- 然后使用 **`get_life_event_details`** 使用URL获取所有程序
**具体行政程序** （护照更新、驾照等）：
- 🔍 **使用 `search_procedures`** -有针对性地搜索特定程序
- 然后使用 **`get_article`** 获取完整细节
**税务信息**:
- 💰 **使用 `search_impots`** 表格和税务程序
- 然后使用 **`get_impots_article`** 了解详细信息
### 服务-公共.gouv.fr工具
#### 1.搜索_程序
在service-public.gouv.fr上搜索程序。
**输入：**
- `query` （string）：程序搜索查询
- `limit` （int，可选）：返回的最大结果数（1-100，默认值：10）
**输出：**
- `results`：包含标题、URL和描述的匹配过程数组
#### 2.获取_条
从service-public.gouv.fr上的特定文章URL检索详细信息。
**输入：**
- `url` （string）：要检索的文章的URL
**输出：**
- `title`：文章标题
- `content`：文章全文
- `url`：文章URL
#### 3.列表_类别
列出可用的公共服务信息类别。
**输出：**
- `categories`：包含名称和描述的可用类别数组
#### 4.list_life事件
从service-public.gouv.fr的“Comment faire si”部分列出所有可用的生活事件（événements de vie）。这些是针对怀孕、搬家、退休等主要生活情况的全面实用指南。
**输出：**
- `events`：包含标题、URL和描述的生活事件数组
**示例事件：**
- 《期待一个孩子》（Expecting a Child）
- “在法国境内移动”（Moving in France）
- “爱人之死”（Death of a Loved One）
- “准备退休”（Preparing for Retirement）
#### 5.获取事件详情
检索特定生活事件的详细信息，包括按主题（健康、公民身份、就业等）组织的所有部分。
**输入：**
- `url` （string）：要检索的生命事件的URL（来自list_life-events结果）
**输出：**
- `title`：生活事件标题
- `url`：生活事件URL
- `introduction`：概述文本
- `sections`：包含标题和内容的详细章节数组
**另请参见：** 生活事件文档
### Impots.gouv.fr工具
#### 4.搜索内容
在impots.gouv.fr上搜索税务表格、文章和程序。
**输入：**
- `query` （string）：搜索税务信息和表格（例如，“公式2042”、“PEA”）
- `limit` （int，可选）：返回的最大结果数（1-100，默认值：10）
**输出：**
- `results`：包含标题、URL、描述、类型和日期的匹配税务文档数组
**示例查询：**
- “公式2042”-查找所得税申报表
- “PEA”-查找有关股票储蓄计划的信息
- “crédit d’impôt”-查找有关税收抵免的信息
#### 5.获取素材_文章
从impots.gouv.fr上的特定税务文章或表格URL检索详细信息。
**输入：**
- `url` （string）：要检索的税务文章或表单的URL
**输出：**
- `title`：文档标题
- `content`：完整文档内容
- `url`：文档URL
- `type`：文件类型（公式、文章等）
- `description`：简要说明
#### 6.列表_项目_类别
在impots.gouv.fr上列出可用的税务信息类别。
**输出：**
- `categories`：包含名称、描述和URL的税务类别数组（Particulier、Professional、Partenaire、Collectivité、International）
## 截图
## 文档
对于开发者和贡献者：
- 开发指南 -本地开发、测试和贡献指南
- 发布过程 -如何创建和自动化发布
- Web抓取实现 -service-public.gouv.fr抓取的技术细节
- Colly集成指南 -Web抓取框架文档
## 许可证
MIT许可证-有关详细信息，请参阅许可证文件