MCP Pappers

MCP Pappers服务器

pappers.fr API（法国公司数据）的MCP服务器，使用官方Python MCP SDK构建。

安装

# Installer uv si nécessaire
curl -LsSf https://astral.sh/uv/install.sh | sh

# Créer l'environnement et installer les dépendances
uv venv
source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows
uv pip install -e .

配置

创建文件 .env 使用您的Pappers API密钥：

PAPPERS_API_KEY=your_api_key_here

获取免费API密钥：https://www.pappers.fr/api

⚠️ 重要

此服务器旨在： 部署在Alpic.ai上 与运输 streamable-http.它未配置为本地使用Claude Desktop（需要 transport="stdio").

要部署自己的服务器，请按照以下说明操作。

MCP工具可用

1. search_companies

按名称搜索法国公司。

设置 ：

• query （str）：公司名称（例如：“谷歌法国”）
• page （int，可选）：分页的页码（默认值：1）
• per_page （int，可选）：每页结果数，最大100（默认值：10）

示例：

{
  "query": "Google France",
  "page": 1,
  "per_page": 10
}

2. get_company_details

通过Siren获取公司的完整详细信息。

设置 ：

• siren （STR）：公司警报器号码（9位数字）

示例：

{
  "siren": "443061841"
}

在Alpic.ai上部署

1.准备部署

服务器为alpic.ai配置了：

• FastMCP（包含在软件包中） mcp，由alpic.ai支持）
• 运输 streamable-http （建议用于云部署）
• 通过配置 alpic.yaml

2.在GitHub上推送

git add .
git commit -m "Ready for deployment"
git push origin main

3.从alpic.ai接口部署

1. 登录https://alpic.ai
2. 单击“新建服务器”或“部署”
3. 允许alpic.ai访问您的GitHub存储库
4. 选择您的存储库 mcp-pappers
5. 选择分支 main
6. Alpic.ai自动检测 alpic.yaml 并启动部署

完整文档：https://docs.alpic.ai/quickstart

4.配置环境变量

选项A：通过仪表板alpic.ai

在部署的服务器界面中，添加：

• PAPPERS_API_KEY：您的Pappers API密钥（必需）
• MCP_API_KEY：保护访问的密钥（可选）

选项B：上传.env文件

创建一个 .env 本地并通过alpic.ai仪表板上传：

PAPPERS_API_KEY=your_pappers_api_key
MCP_API_KEY=your_secret_key  # Optionnel

身份验证模式：

• 模式公开 （默认值）：如果 MCP_API_KEY 未定义，无需身份验证即可访问服务器。
• 保护模式：Si MCP_API_KEY 定义，客户端必须发送标题 x-api-key 对于每个请求。

5.使用已部署的服务器

部署后，您的服务器将通过alpic.ai提供的URL访问：

https://your-server-name-xxxxx.alpic.live

要测试，请在中更改URL test_client.py （第28行）并执行：

python test_client.py

建筑

Client MCP (Test client, applications)
    ↓ HTTPS + SSE/Streamable-HTTP
alpic.ai (Cloud Platform)
    ↓
MCP Server (FastMCP avec streamable-http)
    ↓ REST API + Authentication
Pappers.fr API

运输： streamable-http （部署在Alpic.ai上） 框架： FastMCP（包含在软件包中） mcp) API Pappers.fr v2

发展

Lancer-les测试

uv pip install -e ".[dev]"
pytest

过梁

ruff check .
ruff format .

局限性

• Pappers免费API密钥：每月500个请求
• 只读服务器（无数据更改）
• 数据仅限于法国公司

资源

• API Pappers.fr: https://www.pappers.fr/api/documentation
• Python MCP SDK （FastMCP）：https://github.com/modelcontextprotocol/python-sdk
• MCP协议: https://modelcontextprotocol.io
• alpic.ai文件: https://docs.alpic.ai/
• alpic.ai快速入门: https://docs.alpic.ai/quickstart
• 教程完成：见 TUTORIAL.md

许可证

麻省理工学院