MCP 商业搜索

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

描述

商业搜索 API 允许您搜索和查找法国公司。它提供两种类型的搜索：

• 文本搜索（姓名、地址、领导人和当选官员）

• 地理搜索

Related MCP server: Data Gouv MCP Server

特征

MCP 允许您：

• 按不同标准搜索公司

• 通过多个参数过滤结果

• 访问基本公司信息（名称、SIREN、SIRET、NAF 代码）

• 使用以下参数围绕某个点执行地理搜索：

  • 搜索点的经纬度

  • 搜索半径（最远50公里）

  • 活动过滤器（NAF 代码、活动部分）

  • 结果分页

来源

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

限制

该 API 有一些限制：

• 不提供对机构前任和继任者的访问权限

• 不允许访问不可传播的公司

• 不允许被拒绝在 RCS 注册的公司访问

• 地理搜索半径最大限制为 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 中使用此 MCP，请将以下配置添加到您的.cursor/settings.json文件：

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

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

为贡献者提供的 MCP 资源

官方文档

• MCP 文档

• MCP 规范

• 服务器示例

开发工具

• MCP TypeScript SDK

• MCP Inspector - 调试和分析工具

最佳实践

• 使用 TypeScript SDK 进行实现

• 遵循项目代码约定

• 实施强大的错误处理

• 清晰地记录 API

• 保持与未来版本的兼容性

测试和调试

• 使用检查器进行调试

• 实施单元测试

• 检查是否符合 MCP 规范

• 使用适当的工具分析性能

执照

该项目已获得 MIT 许可。有关详细信息，请参阅LICENSE文件。

贡献

欢迎投稿！查看我们的贡献指南以获取有关如何为该项目做出贡献的更多信息。