权限管理服务器

Name: 权限管理服务器
Author: guigui42

作者：guigui42105 星标更新：2025-10-31

安装使用来源：spider==github.com

项目介绍

技术文档摘要

VosDroits MCP Server

这是一个模型上下文协议（MCP）服务器，提供从service-public.gouv.fr和impots.gouv.fr检索法国公共服务和税务信息的功能。

描述

此MCP服务器使AI助手能够搜索并检索官方的法国行政程序和税务信息。该服务器使用Go语言构建，并通过智能网络爬虫提供支持，它提供了八种主要功能：

Service-Public.gouv.fr 工具

search_procedures：查找相关的公共服务程序和文章
get_article：从特定的service-public.gouv.fr文章中获取完整信息
list_categories：浏览可用的公共服务信息类别
list_life_events：列出所有可用的生活事件（événements de vie）指南
get_life_event_details：获取特定生活情况的详细信息

Impots.gouv.fr 工具

search_impots：在impots.gouv.fr上搜索税务表格、文章和程序
get_impots_article：从特定的税务文章或表格中获取详细信息
list_impots_categories：列出可用的税务服务类别

安装

下载预编译二进制文件

从发布页面下载适用于您平台的最新版本。

可用平台：

Linux：amd64, arm64
macOS：amd64 (Intel), arm64 (Apple Silicon)
Windows：amd64

# 示例：下载并运行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容器注册表中的官方镜像：

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文档。

一键安装：

手动安装：

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

使用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聊天中可用，您可以使用提供的工具查询法国公共服务信息。

GitHub Copilot CLI

要使用GitHub Copilot CLI的这个MCP服务器，需将配置添加到您的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 Desktop

要在Claude Desktop中使用此MCP服务器，需将配置添加到您的MCP设置文件中：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%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 获取详细信息

Service-Public.gouv.fr 工具

1. search_procedures

在service-public.gouv.fr上搜索程序。

输入：

query（字符串）：用于程序的搜索查询
limit（整数，可选）：返回结果的最大数量（1-100，默认值：10）

输出：

results：匹配程序的数组，包括标题、URL和描述

2. get_article

从service-public.gouv.fr上的特定文章URL中获取详细信息。

输入：

url（字符串）：要检索的文章的URL

输出：

title：文章标题
content：全文内容
url：文章URL

3. list_categories

列出公共服务信息的可用类别。

输出：

categories：可用类别的数组，包括名称和描述

4. list_life_events

列出service-public.gouv.fr“Comment faire si”部分的所有可用生活事件（événements de vie）。这些是针对重大生活情况（如期待孩子、搬家、退休等）的综合实用指南。

输出：

events：生活事件的数组，包括标题、URL和描述

示例事件：

"J'attends un enfant"（期待孩子）
"Je déménage en France"（在法国搬家）
"Un proche est décédé"（亲人去世）
"Je prépare ma retraite"（准备退休）

5. get_life_event_details

获取特定生活事件的详细信息，包括按主题组织的所有部分（健康、民事状态、就业等）。

输入：

url（字符串）：要检索的生活事件的URL（来自list_life_events的结果）

输出：

title：生活事件标题
url：生活事件URL
introduction：概述文本
sections：详细部分的数组，包括标题和内容

另见： 生活事件文档

Impots.gouv.fr 工具

4. search_impots

在impots.gouv.fr上搜索税务表格、文章和程序。

输入：

query（字符串）：税务信息和表格的搜索查询（例如，“formulaire 2042”，“PEA”）
limit（整数，可选）：返回结果的最大数量（1-100，默认值：10）

输出：

results：匹配税务文档的数组，包括标题、URL、描述、类型和日期

示例查询：

"formulaire 2042" - 查找所得税申报表
"PEA" - 查找关于股票储蓄计划的信息
"crédit d'impôt" - 查找关于税收抵免的信息

5. get_impots_article

从impots.gouv.fr上的特定税务文章或表格URL中获取详细信息。

输入：

url（字符串）：要检索的税务文章或表格的URL

输出：

title：文档标题
content：全文内容
url：文档URL
type：文档类型（Formulaire、Article等）
description：简短描述

6. list_impots_categories

列出impots.gouv.fr上的税务信息的可用类别。

输出：

categories：税务类别的数组（个人、专业、合作伙伴、集体、国际），包括名称、描述和URL

屏幕截图

文档

对于开发者和贡献者：

开发指南 - 本地开发、测试和贡献指南
发布流程 - 发布创建和自动化过程
网络爬虫实现 - 关于service-public.gouv.fr爬虫的技术细节
Colly集成指南 - 网络爬虫框架文档

许可证

MIT许可证 - 详情请参阅LICENSE文件