tenderapi-mcp

TenderAPI MCP 服务

将 TenderAPI（法国 BOAMP + 欧盟 TED 公共采购数据）封装为 MCP 工具，供 AI Agent 使用（Claude Desktop、Cursor、Continue、Zed 等）。

这是对 https://tenderapi.fr 公共 REST API 的轻量封装。

覆盖范围：自 2015 年 3 月起的 BOAMP（法国），以及自 2015 年起的 TED（覆盖 FR/DE/IT/ES/UK；2023 年底之前采用旧版 XML 格式，之后采用 eForms），每日更新。

两种使用方式

1. 托管服务 — 无需安装，无需密钥

最快的试用方式。将任意 MCP 客户端指向托管端点：

https://tenderapi.fr/mcp

Claude Desktop / Claude Code：

{
  "mcpServers": {
    "tenderapi": {
      "type": "streamable-http",
      "url": "https://tenderapi.fr/mcp"
    }
  }
}

提供 search_tenders 和 get_tender。**匿名免费使用，每个 IP 每日最多调用工具 30 次。**无需账户，也无需安装任何内容。

匿名用户无法使用中标信息、获胜方情报和提醒配置文件——这些功能需要密钥，详见下文。

2. 本地服务（pip）— 完整工具集

需要 Python 3.10+ 和免费 API 密钥。

pip install tenderapi-mcp

在 https://tenderapi.fr/ 获取免费密钥（包含每周一封邮件提醒），然后：

{
  "mcpServers": {
    "tenderapi": {
      "command": "tenderapi-mcp",
      "env": {
        "TENDERAPI_KEY": "ta_your_key_here"
      }
    }
  }
}

Claude Desktop 配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

重启客户端。工具选择器中应会出现 tenderapi 服务。

也可以从源代码安装，而非从 PyPI 安装：

git clone https://github.com/IDNSIDNS/tenderapi-mcp
cd tenderapi-mcp
pip install -e .

任何支持 stdio 传输的 MCP 客户端均可使用。通过 pip 安装的 tenderapi-mcp 二进制文件是入口点。

提供的工具

工具	层级	托管版（无需密钥）	说明
search_tenders	免费	✅	使用类型化筛选条件（CPV、地区、预算、截止日期、来源等）搜索 BOAMP + TED 招标
get_tender	免费	✅	按 ID 获取单条招标信息
search_awards	Pro	—	搜索授标公告（谁中标了哪份合同，金额是多少）
get_award	Pro	—	按 ID 获取单条授标信息
winner_intel	Pro	—	汇总获胜方统计信息：按 CPV / 地区 / 年份排列的顶尖公司
me	任意	—	当前密钥层级、剩余配额、可用功能
list_profiles、get_profile、create_profile、update_profile、delete_profile	免费（1 个，每周邮件）/ Pro	—	管理新招标匹配提醒配置文件：免费密钥每周发送邮件；Pro 每天发送邮件摘要、Teams 卡片或 Webhook
upgrade_tier、billing_portal	任意	—	Stripe 结账和账单管理链接

默认情况下，search_tenders 会排除 PIN（预先信息公告）；传入 include_planning=true 可将其包含在内。使用 deadline_after / deadline_before 筛选时，没有提交截止日期的公告会被排除，除非设置 include_null_deadline=true。

层级

• 托管版，无需密钥：每个 IP 每日 30 次工具调用，仅限招标信息
• 免费密钥：招标信息、1 个提醒配置文件（每周一向账户邮箱发送邮件摘要）
• Pro（15 €/月）：增加授标信息和获胜方情报，最多 10 个提醒配置文件；每天早晨发送（邮件摘要、Teams 或 Webhook）

请求限制仅用于保护服务（免费：每日 1 000 次、每分钟 30 次；Pro：每日 1 500 次、每分钟 120 次）；分页列表最多返回第 1 000 行。

标价为最终价格——不收取增值税（法国《税法》第 293 B 条）。参见 https://tenderapi.fr/#pricing。

本地开发

通过 TENDERAPI_BASE_URL 覆盖 API 基础 URL（默认为 https://tenderapi.fr）。

要求

固定使用 mcp 1.x 系列：2.0.0 版本移除了 mcp.server.fastmcp，而本服务基于该模块构建。迁移到 2.x API 的工作另行跟踪。

许可证

MIT，参见 LICENSE。