AI导哈

企业搜索API模块

一个用于连接和交互法国政府提供的企业搜索API的模块，支持文本和地理搜索功能。

  • by yoanbernabeu
  • TypeScript
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 yoanbernabeu/mcp-recherche-entreprises

使用说明

MCP公司搜索

⚠️ 本项目不隶属于data.gouv.fr，也不是官方MCP服务器。 data.gouv.fr的官方MCP服务器可在此处获得： Datagouv mcp. 此存储库现已存档。我们建议您使用官方服务器。

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

描述

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

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

功能

MCP允许：

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

源

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

局限性

API有一些限制：

  • 不允许访问机构的前任和继任者
  • 不允许访问不可广播的公司
  • 不允许访问被拒绝在RCS注册的公司
  • 地理搜索半径限制为最大50公里

限制技术

  • 限制为每秒7次呼叫
  • 可用性：上个月100%
  • 访问：对所有人开放

使用

作为用户

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

npx mcp-recherche-entreprises

作为开发者

  1. 安装依赖项：
npm install
  1. 项目建设：
npm run build

该命令将：

  • 将TypeScript文件编译为JavaScript
  • 将它们放在文件夹中 dist/
  • 使JavaScript文件可执行
  1. 开始：

要使用Inspector MCP在开发模式下启动服务器（建议用于开发）：

npm run dev

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

npm start

MCP检查器提供了一个图形界面，用于实时测试和调试MCP请求。

与Cursor一起使用

要在光标中使用此MCP，请在文件中添加以下配置： .cursor/settings.json :

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

此配置将允许Cursor自动将此MCP用于公司搜索。

贡献者的MCP资源

官方文件

开发工具

良好做法

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

测试和调试

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

许可证

该项目获得MIT许可。查看文件 许可证 更多详情。

贡献

欢迎捐款！查看我们的 贡献指南 有关如何为本项目做出贡献的更多信息。

相关 MCP