vergabe-mcp
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-mcpClaude Desktop —— 在 claude_desktop_config.json 中:
{
"mcpServers": {
"vergabe": {
"command": "npx",
"args": ["vergabe-mcp"]
}
}
}任何其他 stdio 客户端
npx vergabe-mcpStreamable HTTP,如果你的客户端需要 URL 而不是子进程:
npx vergabe-mcp --http --port 3000Related MCP server: germany-tenders
工具
工具 | 功能说明 |
| 使用平面参数搜索标段 —— 自由文本、CPV 前缀、 |
| 按 ID 获取一个公告,返回策划的 |
| 原生 |
| 将 CPV 或 NUTS 代码解析为德文或英文描述。 |
| 构建某天或某月的批量开放数据导出 URL,并附带相关说明。 |
所有五个工具均为只读;服务器不写入任何内容,不在磁盘上存储任何数据,也不持有任何凭证。
资源。 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。
Available Tools
5 toolsget_export_urlBulk export URLARead-only
Builds the URL of the official bulk export for one day or month. The file is a large ZIP, so download it outside this server.
Inputs: day, month, format. Returns: url, note, format
get_tenderGet one noticeARead-only
Fetches a single notice. 'summary' extracts the fields a bidder decides on (deadlines, lot values, suitableFor, document links); the other formats are returned verbatim.
Inputs: noticeId (required), format, noticeVersion. Returns: raw, uri, format, summary, +1 more
lookup_codeLook up a CPV or NUTS codeBRead-only
Resolves a CPV or NUTS code to its official description.
Inputs: code (required), list (required), language. Returns: code, list, description, descriptionDefault
search_tendersSearch German public tendersARead-only
Searches lots on oeffentlichevergabe.de. Defaults to open lots of the competition notice types (cn-standard, cn-social, cn-desg, subco, qu-sy, pin-cfc-standard, pin-cfc-social), newest first. Use search_tenders_raw for anything this does not cover.
Inputs: cpv, nuts, page, sort, +15 more. Returns: page, total, results, pageSize
search_tenders_rawSearch with the native DSLARead-only
Posts a WHERE/FROM/PAGE/ORDER query to /bkmk/searches unchanged. Operators: =, >, >=, <, <=, IN, STARTS_WITH, CONTAINS, MATCH_ALL, MATCH_ANY, RANGE_DAYS. Fields on lots: allFreeText, description, allCpvCodes, allContractNatures, active, noticeType, suitableFor (freelance|selbst|startup|other-sme), estimatedValue ('150000 EUR'), publicationDate, firstDeadline, allDeadlines, allPlacesOfPerformanceNutsCodes, contractingPlatform, procedureType, procedureLegalBasis, procedureIdentifier. Text and temporal operators take exactly one operand; IN and STARTS_WITH OR a list. RANGE_DAYS n means field >= midnight Europe/Berlin of today + n days, not a window. See the vergabe://api-reference resource for the full contract.
Inputs: FROM, PAGE, ORDER, WHERE, +1 more. Returns: offset, elements, totalElements
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation: searching tenders, fetching details, raw querying, code lookup, and export URL generation. There is no overlap between their purposes.
All tool names follow a clear verb_noun pattern (search_tenders, get_tender, search_tenders_raw, lookup_code, get_export_url). The conventions are uniform and predictable.
Five tools are well-scoped for a public procurement domain. Each tool addresses a necessary function without being excessive or insufficient.
Core workflows for searching, fetching, raw querying, code lookup, and export are covered. Minor gaps like bulk export download instructions are handled via external guidance, which is acceptable.
Maintenance
Related MCP Connectors
Germany public procurement MCP — official German government tenders (keyless).
MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.
German public tenders and contract awards: search, deadlines, winners, market figures. Open data.
TED MCP Server: Real-time EU public tenders access. https://www.lexsocket.ai/
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for German public procurement data (OCDS). Semantic search, tender matching, and company profiles — all from your local LLM105MIT
- AlicenseNot gradedqualityCmaintenanceAccess official German government public procurement tenders via MCP, with keyless access.83 npmMIT
- AlicenseAqualityAmaintenanceMCP server providing read access to Swiss public procurement data via the official simap.ch API, covering all cantons and the Confederation with intraday updates. It enables searching tenders, awards, construction codes, and procurement offices through natural language queries.971 PyPIMIT

vartoofficial
AlicenseNot gradedqualityDmaintenanceMCP server for Ukrainian public procurement (Prozorro) that exposes tools to search tenders, retrieve tender details and cards, list and read tender documents.ISC