MCP Vosdroits

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

# 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容器注册表中提取并运行官方镜像：

docker pull ghcr.io/guigui42/mcp-vosdroits:latest
docker run -i ghcr.io/guigui42/mcp-vosdroits:latest

VSCode与GitHub Copilot

要在VSCode中将此MCP服务器与GitHub Copilot一起使用，您需要在MCP设置中对其进行配置。看 VSCode MCP文档 了解详细信息。

一键安装：

手动安装：

跟随 MCP安装指南，并使用下面的标准配置。应将配置添加到MCP设置文件中（通常 ~/Library/Application Support/Code/User/mcp.json 在macOS上）。

使用Docker镜像（推荐）：

{
  "servers": {
    "vosdroits": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/guigui42/mcp-vosdroits:latest"
      ]
    }
  }
}

使用本地二进制：

如果您从源代码构建了服务器：

{
  "servers": {
    "vosdroits": {
      "command": "/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits"
    }
  }
}

使用环境变量：

为日志记录和超时配置自定义环境变量：

{
  "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镜像（推荐）：

{
  "mcpServers": {
    "vosdroits": {
      "type": "local",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/guigui42/mcp-vosdroits:latest"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

使用本地二进制：

如果您从源代码构建了服务器：

{
  "mcpServers": {
    "vosdroits": {
      "type": "local",
      "command": "/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits",
      "args": [],
      "tools": [
        "*"
      ]
    }
  }
}

使用环境变量：

为日志记录和超时配置自定义环境变量：

{
  "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镜像（推荐）：

{
  "mcpServers": {
    "vosdroits": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/guigui42/mcp-vosdroits:latest"
      ]
    }
  }
}

使用本地二进制：

如果您从源代码构建了服务器：

{
  "mcpServers": {
    "vosdroits": {
      "command": "/absolute/path/to/mcp-vosdroits/bin/mcp-vosdroits",
      "args": []
    }
  }
}

使用环境变量：

为日志记录和超时配置自定义环境变量：

{
  "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许可证-有关详细信息，请参阅许可证文件