MCP 商业搜索
此 MCP(API 连接模块)允许您与 data.gouv.fr 提供的商业搜索 API 进行交互。
描述
商业搜索 API 允许您搜索和查找法国公司。它提供两种类型的搜索:
特征
MCP 允许您:
- 按不同标准搜索公司
- 通过多个参数过滤结果
- 访问基本公司信息(名称、SIREN、SIRET、NAF 代码)
- 使用以下参数围绕某个点执行地理搜索:
- 搜索点的经纬度
- 搜索半径(最远50公里)
- 活动过滤器(NAF 代码、活动部分)
- 结果分页
来源
此 MCP 基于官方 data.gouv.fr API:商业搜索 API
限制
该 API 有一些限制:
- 不提供对机构前任和继任者的访问权限
- 不允许访问不可传播的公司
- 不允许被拒绝在 RCS 注册的公司访问
- 地理搜索半径最大限制为 50 公里
技术限制
- 每秒最多 7 次调用
- 可用性:上个月 100%
- 访问:向所有人开放
使用
作为用户
使用此 MCP 的最简单方法是通过npx
:
npx mcp-recherche-entreprises
作为开发人员
- 安装依赖项:
- 项目建设:
此命令将:
- 将 TypeScript 文件编译为 JavaScript
- 将它们放在
dist/
文件夹中 - 使 JavaScript 文件可执行
- 启动:
要使用 MCP Inspector 以开发模式启动服务器(推荐用于开发):
要不使用 Inspector 启动服务器:
MCP Inspector 提供了一个图形界面,用于实时测试和调试 MCP 请求。
与光标一起使用
要在 Cursor 中使用此 MCP,请将以下配置添加到您的.cursor/settings.json
文件:
{
"mcpServers": {
"recherche-entreprises": {
"command": "npx mcp-recherche-entreprises"
}
}
}
此配置将允许 Cursor 自动使用此 MCP 进行商业搜索。
为贡献者提供的 MCP 资源
官方文档
开发工具
最佳实践
- 使用 TypeScript SDK 进行实现
- 遵循项目代码约定
- 实施强大的错误处理
- 清晰地记录 API
- 保持与未来版本的兼容性
测试和调试
- 使用检查器进行调试
- 实施单元测试
- 检查是否符合 MCP 规范
- 使用适当的工具分析性能
执照
该项目已获得 MIT 许可。有关详细信息,请参阅LICENSE文件。
贡献
欢迎投稿!查看我们的贡献指南以获取有关如何为该项目做出贡献的更多信息。