AI导哈

企业数据API服务

MCP Pappers Server是一个基于Python MCP SDK构建的企业数据API服务，主要用于查询法国企业的详细信息。

  • by BittnerPierre
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 BittnerPierre/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

许可证

麻省理工学院

相关 MCP