MCP Insee Entreprises

Insee企业MCP服务器

    

MCP（模型上下文协议）服务器，用于查询API SIRENE INSEE和搜索法国公司。

功能

🔍 可用工具

1. 搜索\_ \_警报器 -按警报器编号搜索（9位数字）

- 使用官方Insee Sirene API - 返回法律单位的完整和官方信息 - 数据：姓名、法律类别、活动（NAF）、工作人员、行政状态

1. 搜索_by_siret -按SIRET编号搜索（14位数字）

- 使用官方Insee Sirene API - 返回机构的完整和官方信息 - 数据：完整地址、活动（NAF）、机构类型（总部/二级）、员工人数、行政状态

1. 搜索公司 -使用多个过滤器进行高级搜索

- 公司名称、地址、经理 - 地理过滤器：邮政编码、市、县、地区 - 代码NAF/APE - 活动部分（A-U），自动转换名称→代码 - 员工人数（最小/最大） - 分页可用

先决条件

• Python 3.12+
• UV（Python包管理器）
• Insee API密钥（免费）- 拿到钥匙
• JQ（用于Bash脚本中的JSON格式）
• yq（将OpenAPI YAML模式转换为JSON）

安装JQ和YQ

安装程序jq：

sudo apt-get install jq

要安装YQ（推荐Go版本）：

sudo wget -O /usr/local/bin/yq "https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64"
sudo chmod +x /usr/local/bin/yq

Ou通过pip（Python版本）：

pip install yq

UV安装器

浇注安装器 uv，运行以下命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

有关更多信息，请参阅官方文档：https://astral.sh/uv/docs/getting-started/installation

要检查安装，请运行：

uv --version

要了解安装路径： uv，执行：

which uv

添加 uv 在PATH环境变量中，将以下行添加到shell配置文件（~/.bashrc, ~/.zshrc等等）：

export PATH="$HOME/.local/bin:$PATH"

修改此文件后，使用以下方法重新加载shell配置：

source ~/.bashrc

安装MCP服务器

1. 克隆存储库 （如果尚未完成）：

git clone git@github.com:DavidScanu/mcp-insee-entreprises.git
cd mcp-insee-entreprises

1. 使用UV安装依赖项 :

uv sync

1. 配置INSEE API密钥 :

创建文件 .env 在项目的根源：

cp .env.example .env

编辑文件 .env 并添加您的INSEE API密钥：

INSEE_API_KEY=votre_clé_api_ici

备注 ：要获得免费的INSEE API密钥，请访问https://portail-api.insee.fr/

1. 将MCP服务器添加到Claude代码 （范围用户）：

claude mcp add --transport stdio insee-entreprises --scope user -- uv --directory  run insee-entreprises

备注 替换： `` 通过服务器安装的绝对路径。

备选方案si uv 不在你的道路上 :

如果命令 uv 无法识别，请使用完整路径 uv （通常 ~/.local/bin/uv 或 ~/.cargo/bin/uv) :

claude mcp add --transport stdio insee-entreprises --scope user -- ~/.local/bin/uv --directory  run insee-entreprises

找到完整的路径 uv，使用：

which uv

1. 检查安装 :

claude mcp list

安装手册（备选）

如果您希望手动配置，请将其添加到文件中 ~/.claude.json :

{
  "mcpServers": {
    "insee-entreprises": {
      "command": "uv",
      "args": [
        "--directory",
        "/home/david/mcp-servers/mcp-insee-entreprises",
        "run",
        "insee-entreprises"
      ]
    }
  }
}

是 uv 不在你的道路上，使用绝对路径 uv :

{
  "mcpServers": {
    "insee-entreprises": {
      "command": "/home/david/.local/bin/uv",
      "args": [
        "--directory",
        "/home/david/mcp-servers/mcp-insee-entreprises",
        "run",
        "insee-entreprises"
      ]
    }
  }
}

备注 ：使用 which uv 找到确切的路径 uv 在你的系统上。

备注 ：对于Claude Desktop，请改用Claude桌面配置文件（~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上或 %APPDATA%\Claude\claude_desktop_config.json 在Windows上）。

配置

安装范围

此服务器安装于 范围用户这意味着它是：

• 适用于您的所有项目Claude Code
• 存储在 ~/.claude.json
• 私人到您的用户帐户

自动允许函数调用（用户范围）

为了避免每次使用MCP服务器进行搜索时单击“是”，您可以通过添加级别权限自动允许INSEE服务器上的所有工具。 用户 （所有项目）。

步骤1：验证MCP服务器是否已配置

确保服务器 insee-entreprises 在中定义良好 ~/.claude.json :

claude mcp list

你应该看看 insee-entreprises 在列表中。

步骤2：创建或编辑全局设置文件

创建或编辑文件 ~/.claude/settings.json :

{
  "enableAllProjectMcpServers": true,
  "permissions": {
    "allow": [
      "mcp__insee-entreprises__*"
    ]
  }
}

参数说明：

• "enableAllProjectMcpServers": true ：自动激活文件中定义的所有MCP服务器 .mcp.json 你的项目
• "permissions.allow" ：自动允许的工具列表
• "mcp__insee-entreprises__*" ：允许MCP服务器上的所有工具 insee-entreprises （le * est非通配符）

步骤3：重新启动Claude代码

关闭并重新启动Claude代码以使更改生效。

核查

配置后，您可以使用MCP工具，无需任何授权请求：

Recherche les entreprises nommées "Carrefour"

Claude将直接使用MCP服务器，无需确认。

备选方案：仅允许特定工具

如果您希望仅允许某些工具（例如，仅使用警报器搜索），请替换通配符 * 按工具名称：

{
  "permissions": {
    "allow": [
      "mcp__insee-entreprises__search_by_siren",
      "mcp__insee-entreprises__search_by_siret"
    ]
  }
}

服务器管理

# Lister tous les serveurs MCP configurés
claude mcp list

# Obtenir les détails du serveur
claude mcp get insee-entreprises

# Supprimer le serveur
claude mcp remove insee-entreprises

# Vérifier le statut (dans Claude Code)
/mcp

使用

配置服务器后，您可以在Claude Desktop中使用它：

请求示例

1. 重新研究SIREN

   Trouve-moi les informations sur l'entreprise avec le SIREN 552032534

1. 重新搜索名称

   Recherche les entreprises nommées "Carrefour"

1. 按领导者搜索

   Trouve les entreprises dirigées par "Jean Dupont"

1. 按活动搜索

   Liste les entreprises avec le code NAF 62.01Z (programmation informatique)

1. 高级搜索

   Trouve les entreprises de programmation informatique à Paris avec plus de 50 employés

1. 活动部分研究

   Liste les entreprises dans la section "Construction" à Marseille

或

   Recherche les entreprises dans le secteur de l'information et communication (section J)

NAF活动部分

服务器支持按活动部分（NAF术语的1级）进行搜索。您可以使用代码（字母A-U）或章节标签。

地理过滤

服务器支持多个级别的地理过滤：

邮政编码

Recherche les entreprises dans le code postal 75001

公社（代码INSEE）

Trouve les entreprises à Lyon (code commune 69123)

部门

Liste les entreprises en Isère (département 38)

区域

Recherche les entreprises en Auvergne-Rhône-Alpes (région 84)

组合过滤器

Trouve les entreprises de construction dans le département 38 avec plus de 100 employés

INSEE地理代码

地理代码遵循INSEE官方命名法（COG 2025）：

注： 所有地理设置都接受逗号分隔的值列表，用于搜索多个区域（例如： departement=38,69 对于Isère和Rhône）。

按地理名称搜索

MCP服务器集成了一个映射服务，允许按地理名称而不是代码进行搜索：

区域：

Recherche les entreprises en Auvergne-Rhône-Alpes

服务器将自动将“奥弗涅-罗讷-阿尔卑斯”转换为区号“84”。

部门：

Trouve les entreprises dans le département de l'Isère

服务器将自动将“isère”转换为部门代码“38”。

公社：

Liste les entreprises à Grenoble

服务器将自动将“格勒诺布尔”转换为通用代码“38185”。

市政当局的重要注意事项： 许多城市可能有相同的名称。在这种情况下，还应指定要消除歧义的部门：

Trouve les entreprises à Saint-Martin dans le département 38

地理代码来源：

• COG 2025（官方地理代码）
• 综合数据：地区、省、市（2025年1月更新）

返回的信息

对于每个公司，服务器返回：

• 识别 ：Siren、Siret、公司名称
• 活动 ：NAF/APE和libellé代码
• 地址 ：总部的完整地址
• 状态 ：活动/非活动
• 工作人员 ：雇员人数
• 领导人 ：领导人名单及其职能

使用的API

该MCP服务器使用INSEE的两个互补API：

1.API INSEE Sirene（官方）

用于研究 塞壬 和 公司及商业机构注册号 -官方和完整数据：

• 基本URL: https://api.insee.fr/api-sirene/3.11
• 认证：需要API密钥（免费）-通过文件配置 .env
• 端点:

- /siren/{siren} -法律单位信息 - /siret/{siret} -机构信息

• 极限：30个请求/分钟（在集成环境中）

文档

• API门户：https://portail-api.insee.fr/（获取API密钥）
• 完整文档：https://portail-api.insee.fr/catalog/api/2ba0e549-5587-3ef1-9082-99cd865de66f/doc
• OpenAPI规范：https://api-apimanager.insee.fr/portal/environments/DEFAULT/apis/2ba0e549-5587-3ef1-9082-99cd865de66f/pages/6548510e-c3e1-3099-be96-6edf02870699/content

cURL请求示例

SIRET的研究：

curl -X GET "https://api.insee.fr/api-sirene/3.11/siret/67205008502051" \
  -H "X-INSEE-Api-Key-Integration: VOTRE_CLE_API_INSEE"

具有从文件自动恢复密钥的功能 .env :

source .env && curl -X GET "https://api.insee.fr/api-sirene/3.11/siret/67205008502051" \
  -H "X-INSEE-Api-Key-Integration: $INSEE_API_KEY"

通过JSON格式 jq :

source .env && curl -X GET "https://api.insee.fr/api-sirene/3.11/siret/67205008502051" \
  -H "X-INSEE-Api-Key-Integration: $INSEE_API_KEY" | jq '.'

使用地理过滤器的查询示例

使用地理过滤器搜索公司（公司搜索API）：

# Recherche par code postal
curl -X GET "https://recherche-entreprises.api.gouv.fr/search?code_postal=38000&per_page=5"

# Recherche par département
curl -X GET "https://recherche-entreprises.api.gouv.fr/search?departement=38&per_page=5"

# Recherche par région
curl -X GET "https://recherche-entreprises.api.gouv.fr/search?region=84&per_page=5"

# Recherche combinée: département + section d'activité
curl -X GET "https://recherche-entreprises.api.gouv.fr/search?departement=38&section_activite_principale=F&per_page=10"

# Recherche avec plusieurs départements
curl -X GET "https://recherche-entreprises.api.gouv.fr/search?departement=38,69&per_page=10"

# Recherche avec code commune
curl -X GET "https://recherche-entreprises.api.gouv.fr/search?code_commune=38185&per_page=5"

2.企业搜索API

用于研究 高级 具有多个过滤器：

• 基本URL: https://recherche-entreprises.api.gouv.fr
• 认证：无（免费访问）
• 极限每秒7个请求
• 可用性: 100%

文档

• 文档：https://www.data.gouv.fr/dataservices/api-recherche-dentreprises
• 斯威格：https://recherche-entreprises.api.gouv.fr/docs/
• OpenAPI：https://recherche-entreprises.api.gouv.fr/openapi.json

限制

• 无法访问机构的前任/继任者
• 无法访问不可广播的公司
• 无法访问RCS注册拒绝

API测试

非脚本bash scripts/insee_api.sh 包括测试对两个API的调用。确保你有 jq 和 yq 安装用于格式化JSON和将YAML转换为JSON。

chmod +x scripts/insee_api.sh
./scripts/insee_api.sh

故障排除 :

• 无效或缺少 INSEE API 密钥：检查文件内容 .env et la变量 INSEE_API_KEY.
• 显示不正确的特殊字符©, 等）：确保终端和文件为UTF-8。
• 错误：未安装YQ：安装 yq.
• 错误：未安装JQ：安装 jq.

______________________________________________________________________

全部

• ✅ 按地理条件（地区、县、市、邮政编码）添加搜索
• ✅ 重命名 advanced_search 英语 search_entreprises
• ✅ 地区、县和市的地理地图服务（名称→代码）
• ✅ 通过Siren和Siret测试MCP服务器搜索（官方API Insee Sirene 3.11）
• 使用新版本的Insee Sirene API（v4.0）测试MCP服务器
• 在文档中添加高级使用示例
• 每年更新COG数据（官方地理代码）

______________________________________________________________________

开发商

MCP服务器由 大卫·斯坎努

• https://github.com/DavidScanu
• https://www.linkedin.com/in/davidscanu14/