vergabe-mcp

一个用于 oeffentlichevergabe.de 的 MCP 服务器，后者是德国联邦公共招标门户。德国所有公共招标都会在此发布，并提供批量开放数据导出，但该导出会延迟一天，以每日 ZIP 形式提供，且无法筛选——你需要下载所有数据然后自行整理。门户自身的搜索 API 可以进行筛选（CPV 代码、地区、截止日期窗口、eForms 的“适合自由职业者”标志），并且在公告发布时即刻更新，但该 API 没有文档。此服务器对其进行了封装，因此任何 MCP 客户端都可以使用真实筛选条件搜索实时信息流，并以门户领域模型、eForms XML 或 OCDS 格式拉取公告。匿名使用，无需 API 密钥，无需账户。

逆向工程的 API 参考文档位于 docs/API.md —— 如果你想直接调用端点而非通过 MCP，它本身即可独立使用。

安装

无需安装；直接使用 npx 运行。

Claude Code

claude mcp add vergabe -- npx vergabe-mcp

Claude Desktop —— 在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "vergabe": {
      "command": "npx",
      "args": ["vergabe-mcp"]
    }
  }
}

任何其他 stdio 客户端

npx vergabe-mcp

Streamable HTTP，如果你的客户端需要 URL 而不是子进程：

npx vergabe-mcp --http --port 3000

Related MCP server: germany-tenders

工具

所有五个工具均为只读；服务器不写入任何内容，不在磁盘上存储任何数据，也不持有任何凭证。

资源。 vergabe://api-reference 提供 API 文档，以便客户端在编写查询前了解后端实际支持的功能。模板涵盖单个公告 —— vergabe://notice/{noticeId}、.../eforms、.../ocds —— 以及 vergabe://codelist/{list}/{code}。

提示词。 find-solo-tenders（参数：keywords、cpv、maxDays）使用自由职业者/自雇标志进行搜索，然后引导模型进行候选筛选：描述中隐含的人日数、临近截止日期是参与请求还是报价本身、空值字段意味着什么。该筛选知识作为提示词提供，而非评分代码，以便你可以与之讨论。

示例

你： 查找标记为适合自由职业者的开放式 IT 招标。

模型调用 search_tenders，参数为 cpv: ["72"]、suitableFor: ["freelance"]、onlyActive: true。在 2026-08-17 这一天，结果是 30 个开放标段，其中有：

{
  "noticeId": "7c70692d-dfb9-4b96-b777-4a5539eaee50",
  "title": "Beschaffung einer Beratungsdienstleistung zur Fachberatung im Rahmen eines Identity and Access Management (IAM) Projektes für die Stadtwerke Bielefeld (SWB)",
  "lotTitle": "Beratungsdienstleistung zur Fachberatung im Rahmen eines Identity and Access Management (IAM) Projektes",
  "buyer": "Stadtwerke Bielefeld GmbH",
  "cpv": "72260000",
  "noticeType": "cn-standard",
  "nature": "services",
  "deadline": "2026-09-14T10:00:00+02:00",
  "published": "2026-08-12T00:00:00+02:00"
}

然后它对感兴趣的标段调用 get_tender 以读取描述、估计价值和排除理由，之后再告诉你哪些值得投标 —— 这一判断是模型的任务，服务器故意不进行任何评分。

注意该结果中数据的形状：这里的截止日期是 deadlineReceiptRequests，即参与请求，而非报价截止日期。find-solo-tenders 提示词之所以存在，正是因为这类区别决定了某个招标是否可供投标。

开发

Node 20 或更新版本。

npm install
npm test            # vitest, no network
npm run typecheck
npm run lint        # biome

集成测试会访问实时门户，除非你要求，否则会被跳过：

VERGABE_LIVE=1 npm test

提交遵循 Conventional Commits；release-please 将其转换为 main 分支上的发布 PR —— 合并该 PR 会标记发布、写入变更日志、发布到 npm，并将 tarball 附加到 GitHub 发布。提交类型决定版本号的提升。

许可证

MIT。