使用说明

项目简介

legifrancemcp 是一个 MCP (Model Context Protocol) 服务器，旨在为 Claude Desktop 等 MCP 客户端提供访问法国 Légifrance 法律数据库的能力。通过此服务器，用户可以使用自然语言指令，在 Claude Desktop 中调用工具搜索 Légifrance 上的法律条文和判例。

主要功能点

法律信息检索: 提供 'searchLegifrance' 工具，允许用户通过关键词查询 Légifrance 数据库，获取相关的法律文档信息。
MCP 协议支持: 完全实现了 MCP 协议的服务器端，可以与任何兼容 MCP 协议的客户端进行通信。
API 密钥管理: 安全地管理 Légifrance API 的密钥和 OAuth 认证流程。
可配置环境: 支持 Sandbox 和 Production 两种 Légifrance API 环境，方便测试和正式使用。

安装步骤

克隆仓库: 将仓库 'legifrancemcp' 克隆到本地。
安装依赖: 在仓库根目录下运行 'npm install' 命令安装项目依赖。
编译服务器: 运行 'npm run build' 命令编译 TypeScript 代码。

服务器配置

要将此 MCP 服务器与 Claude Desktop 客户端连接，您需要在 Claude Desktop 的配置文件中添加服务器配置信息。配置文件通常位于以下位置：

Windows: '%APPDATA%\Claude'
macOS: '~/Library/Application Support/Claude/'
Linux: '~/.config/Claude/'

在该目录下，创建或编辑 'claude_desktop_config.json' 文件，并添加以下配置信息到 'mcpServers' 字段中。请根据您的实际环境修改 'command' 和 'args' 中的路径，并务必替换 'env' 中的 API 密钥信息。

{
  "mcpServers": {
    "legifrance-server": {
      "command": "node",
      "args": ["/path/to/legifrancemcp/build/index.js"],
      "env": {
        "LEGIFRANCE_CLIENT_ID": "YOUR_CLIENT_ID",  // 您的 Légifrance API Client ID
        "LEGIFRANCE_CLIENT_SECRET": "YOUR_CLIENT_SECRET", // 您的 Légifrance API Client Secret
        "LEGIFRANCE_API_KEY": "YOUR_API_KEY", // 您的 Légifrance API Key
        "LEGIFRANCE_OAUTH_SECRET": "YOUR_OAUTH_SECRET", // 您的 Légifrance API OAuth Secret
        "LEGIFRANCE_API_URL": "https://sandbox-api.piste.gouv.fr/dila/legifrance/lf-engine-app",  // Légifrance API URL (Sandbox 或 Production，根据您使用的环境配置)
        "OAUTH_TOKEN_URL": "https://sandbox-oauth.piste.gouv.fr/api/oauth/token"      // OAuth Token URL (Sandbox 或 Production，与 API URL 对应)
      }
    }
  }
}

注意:

将 '/path/to/legifrancemcp/build/index.js' 替换为 'index.js' 文件的实际绝对路径。
请务必替换 'YOUR_CLIENT_ID'、'YOUR_CLIENT_SECRET'、'YOUR_API_KEY' 和 'YOUR_OAUTH_SECRET' 为您在 PISTE 平台上创建 Légifrance API 应用后获得的凭据。
'LEGIFRANCE_API_URL' 和 'OAUTH_TOKEN_URL' 需要根据您选择的 Légifrance API 环境（Sandbox 或 Production）进行配置。Sandbox 环境适用于测试，Production 环境适用于正式使用，但可能需要 Légifrance 团队的验证。

基本使用方法

配置完成后，启动 Claude Desktop 客户端。您可以使用自然语言指令来调用 'searchLegifrance' 工具。例如，在 Claude Desktop 中输入：

使用 legifrance 搜索 "劳动法" 相关文章

或者更简洁的：

在 legifrance 中搜索 "环境污染责任"

服务器会将查询请求发送到 Légifrance API，并将返回的法律信息结果以 JSON 格式返回给 Claude Desktop。Claude Desktop 可以进一步处理这些信息，并以易于理解的方式呈现给用户。

关键词