使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在通过标准化的 MCP 协议，向 LLM 客户端提供访问法国 Data Gouv 开放数据平台的能力。目前主要集成了“API Recherche Entreprises” (企业搜索API)，允许用户通过 LLM 客户端查询法国企业的公开信息。

主要功能点

企业信息查询工具 (search-company): 提供通过企业名称、CEO 姓名、地址等关键词查询法国企业信息的工具。可以获取企业的名称、地址、管理者列表、行业等详细信息。
MCP over HTTP+SSE: 使用 HTTP+SSE 传输协议，符合 MCP 规范，保证了与 MCP 客户端的兼容性。
易于安装和运行: 基于 Node.js 和 pnpm 构建，提供简单的安装和运行命令。
可调试性: 支持 MCP Inspector，方便开发者调试和监控服务器运行状态。

安装步骤

安装 Node.js 和 pnpm: 确保你的系统已安装 Node.js 22 或更高版本 (lts/jod) 以及 pnpm 10 或更高版本。
克隆仓库: 将 GitHub 仓库 'https://github.com/csonigo/datagouv-mcp-server' 克隆到本地。
安装依赖: 在仓库根目录下，运行命令 'pnpm install' 安装项目依赖。
启动服务器: 在仓库根目录下，运行命令 'pnpm run dev' 启动 MCP 服务器。服务器默认监听 'http://localhost:3001' 的 'sse' 路径。

服务器配置

以下 JSON 配置信息用于 MCP 客户端连接到 Data Gouv MCP Server。你需要将这段配置添加到你的 MCP 客户端的服务器列表中。

{
  "servers": {
    "data-gouv": {  // 服务器名称，可以自定义
      "command": "pnpm", // 启动服务器的命令，这里使用 pnpm
      "args": ["run", "dev"], // 启动服务器命令的参数，这里是运行 dev 脚本
      "serverUrl": "http://localhost:3001/sse" // MCP 服务器的 SSE 端点 URL
    }
  }
}

配置说明:

'servers': 定义 MCP 服务器列表。
'data-gouv': 自定义的服务器名称，用于在客户端中引用。
'command': 启动服务器的可执行命令，例如 'pnpm', 'npm', 'node' 等。这里 'pnpm' 用于执行 'package.json' 中定义的脚本。
'args': 传递给 'command' 的参数数组。 '["run", "dev"]' 表示执行 'pnpm run dev' 命令，启动开发模式的服务器。
'serverUrl': MCP 服务器提供的 SSE (Server-Sent Events) 端点 URL。客户端通过此 URL 与服务器建立连接并进行通信。

基本使用方法

启动 MCP 服务器: 按照上述安装步骤启动 Data Gouv MCP Server。
配置 MCP 客户端: 将上述服务器配置信息添加到你的 MCP 客户端配置中，并确保客户端已连接到 'data-gouv' 服务器。
使用 'search-company' 工具: 在 LLM 客户端中，你可以调用名为 'search-company' 的工具，并提供 'query' 参数来搜索法国企业信息。例如，你可以向 LLM 发送指令：“请使用 'search-company' 工具搜索 '法国巴黎银行' 的信息”。

注意: 本服务器目前只实现了 'search-company' 这一个工具。

关键词