微信扫一扫article
README
🚀 企业搜索MCP
本MCP（API连接模块）可与data.gouv.fr提供的企业搜索API进行交互。它能让用户方便地查找法国企业，支持多种搜索方式和筛选条件，为用户提供了便捷的企业信息查询途径。
✨ 主要特性
- 多样化搜索：支持通过不同标准搜索企业，包括文本搜索（企业名称、地址、负责人和当选官员等）和地理搜索。
- 结果筛选：可根据多个参数对搜索结果进行筛选。
- 核心信息获取：能访问企业的基本信息，如企业名称、SIREN编号、SIRET编号和NAF代码。
- 地理搜索功能：可围绕指定点进行地理搜索，支持设置搜索点的经纬度、搜索半径（最大50公里）、活动过滤器（NAF代码、活动类别），并对结果进行分页。
📦 安装指南
作为普通用户
使用本MCP最简单的方法是通过npx：
npx mcp-recherche-entreprises
作为开发者
- 安装依赖：
npm install
- 构建项目：
npm run build
此命令将执行以下操作：
- 将TypeScript文件编译为JavaScript文件。
- 将编译后的文件放置在
dist/目录中。 - 使JavaScript文件可执行。
- 启动项目：
- 开发模式（推荐）：使用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 TypeScript SDK
- MCP Inspector - 调试和分析工具
最佳实践
- 使用TypeScript SDK进行实现。
- 遵循项目的代码约定。
- 实现强大的错误处理机制。
- 清晰地记录API文档。
- 保持与未来版本的兼容性。
测试与调试
- 使用Inspector进行调试。
- 实现单元测试。
- 验证是否符合MCP规范。
- 使用适当的工具分析性能。
🔧 技术细节
API限制
- 信息访问限制：无法访问企业的前身和后继机构，不能访问不可公开的企业以及注册被拒绝的企业。
- 地理搜索半径限制：地理搜索半径最大为50公里。
技术限制
- 调用频率限制：每秒最多7次调用。
- 可用性：上个月的可用性为100%。
- 访问权限：对所有人开放。
📄 许可证
本项目采用MIT许可证。有关详细信息，请参阅LICENSE文件。
🤝 贡献
欢迎贡献！有关如何为该项目做出贡献的更多信息，请参阅我们的贡献指南。