使用说明
MCP 纸张
MCP服务器，用于访问 Pappers API v2.将人工智能助手与法国公司数据连接起来：法律信息、财务、董事、受益所有人、官方文件等。
[！重要] 这是一个非官方的社区建设项目。它不隶属于、认可或支持 Pappers.您必须拥有有效的Pappers API密钥，并遵守 Pappers使用条款 和 API文档 使用此服务器时。您自行负责API的使用和任何相关费用。
快速开始
启动服务器
PAPPERS_API_KEY=your-key go run github.com/stefanoamorelli/pappers-mcp/cmd/pappers-mcp@latest
服务器监听端口 3000 默认情况下。用覆盖 PORT 环境变量。
克劳德代码
claude mcp add --transport http pappers-mcp http://localhost:3000/mcp
手动配置
{
"mcpServers": {
"pappers-mcp": {
"type": "http",
"url": "http://localhost:3000/mcp"
}
}
}
或者从源代码构建：
go build -o pappers-mcp ./cmd/pappers-mcp
配置
默认情况下，所有24个工具都已注册。您可以通过环境变量限制公开哪些工具：
| 变量 | 描述 |
|---|---|
PAPPERS_ENABLED_TOOLS |
逗号分隔的异体字。只有这些工具被注册。 |
PAPPERS_DISABLED_TOOLS |
逗号分隔的块列表。除这些以外的所有工具都已注册。 |
如果两者都被设置， PAPPERS_ENABLED_TOOLS 优先。如果两者都没有设置，则注册所有工具。
示例：
仅显示公司查找和API信用：
{
"env": {
"PAPPERS_API_KEY": "your-api-key",
"PAPPERS_ENABLED_TOOLS": "get_company_data,get_api_credits"
}
}
暴露除监控工具外的所有内容：
{
"env": {
"PAPPERS_API_KEY": "your-api-key",
"PAPPERS_DISABLED_TOOLS": "add_company_watch,add_director_watch,delete_notifications,add_notification_info"
}
}
工具
| 类别 | 工具 |
|---|---|
| 公司 | 公司数据（SIREN/SIRET/name）、关联数据 1 2 |
| 搜索 | 公司、董事、受益所有人、文件、BODACC出版物 3 |
| 建议 | 公司名称自动补全 4 |
| 财务数据 | 年度账目、公司地图 5 6 |
| 合规 | 政治公众人物/制裁筛查 7 |
| 文件 | Pappers摘录、INPI摘录、INSEE通知、规章制度、UBO声明、财务/非财务报告、文件下载 8 |
| 监视 | 公司/董事观察名单、通知 9 |
| 账户 | API信用使用 10 |
24种工具全面覆盖 Pappers API v2.
发展
make build # Build binary
make test # Run unit tests (no API key needed)
make conformance # Verify all 24 tools are registered
集成测试需要有效的API密钥：
PAPPERS_API_KEY=xxx make test-integration
许可证
版权所有（c）2025 斯特凡诺·阿莫雷利 (stefano@amorelli.tech)
