MCP 公司搜索

此MCP（API连接模块）允许您与data.gouv.fr提供的企业搜索API进行交互。

描述

企业搜索API允许您搜索并找到法国公司。它提供两种类型的搜索：

• 文本搜索（名称、地址、管理人员和选举官员）
• 地理搜索

功能

该MCP允许：

• 根据不同标准搜索公司
• 按多个参数过滤结果
• 访问重要公司信息（名称、SIREN、SIRET、NAF代码）
• 使用以下参数执行地理搜索：
  • 搜索点的纬度和经度
  • 搜索半径（最多50公里）
  • 活动筛选器（NAF代码、活动部分）
  • 分页结果

来源

此MCP基于官方的data.gouv.fr API： 企业搜索API

限制

API有一些限制：

• 不提供机构前后的访问权限
• 不允许访问非广播公司
• 不允许访问被拒绝注册到SCR的公司
• 地理搜索半径限制在最大50公里

技术限制

• 每秒调用次数上限：7次
• 可用性：上个月100%
• 访问：对所有人开放

使用方法

作为用户

使用此MCP最简单的方法是通过npx：

npx mcp-recherche-entreprises

作为开发者

1. 安装依赖项：

npm install

2. 构建项目：

npm run build

此命令将：

• 将TypeScript文件编译成JavaScript
• 将它们放置在dist/文件夹中
• 使JavaScript文件可执行

3. 启动：

要以开发模式启动服务器并使用MCP Inspector（推荐用于开发）：

npm run dev

要在没有Inspector的情况下启动服务器：

npm start

MCP Inspector提供了一个图形界面，用于实时测试和调试MCP查询。

在Cursor中的使用

要在Cursor中使用此MCP，请在您的.cursor/settings.json文件中添加以下配置：

{
  "mcpServers": {
    "recherche-entreprises": {
      "command": "npx mcp-recherche-entreprises"
    }
  }
}

此配置将允许Cursor自动使用此MCP进行企业搜索。

贡献者的MCP资源

官方文档

• MCP文档
• MCP规范
• 服务器示例

开发工具

• TypeScript MCP SDK
• MCP Inspector - 调试和分析工具

好习惯

• 使用TypeScript SDK进行实现
• 遵循项目代码约定
• 实现健壮的错误管理
• 清晰地记录API
• 维护与未来版本的兼容性

测试和调试

• 使用Inspector进行调试
• 实现单元测试
• 检查是否符合MCP规范
• 使用适当的工具分析性能

许可证

本项目采用MIT许可证。查看LICENSE文件获取更多详细信息。

贡献

欢迎贡献！请参阅我们的贡献指南，了解如何为该项目做出贡献的更多信息。