Skip to main content
Glama
vergabe-mcp

vergabe-mcp

by jocks-studio

vergabe-mcp

CI npm

一个用于 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

工具

工具

功能说明

search_tenders

使用平面参数搜索标段 —— 自由文本、CPV 前缀、suitableFor、合同性质、NUTS 地区、平台、截止日期与发布窗口、分页、排序。返回标准化结果。

get_tender

按 ID 获取一个公告,返回策划的 summary(默认)或原始 domain JSON、eforms XML、ocds JSON。

search_tenders_raw

原生 SELECT/FROM/WHERE/PAGE/ORDER DSL,直接透传并返回原始结果 —— 用于策划工具无法表达的任何查询。

lookup_code

将 CPV 或 NUTS 代码解析为德文或英文描述。

get_export_url

构建某天或某月的批量开放数据导出 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 tools
get_export_urlBulk export URLA
Read-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 noticeA
Read-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 codeB
Read-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 tendersA
Read-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 DSLA
Read-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

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    Five tools are well-scoped for a public procurement domain. Each tool addresses a necessary function without being excessive or insufficient.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      MCP 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.
      9
      71 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Ukrainian public procurement (Prozorro) that exposes tools to search tenders, retrieve tender details and cards, list and read tender documents.
      ISC