Skip to main content
Glama
vergabe-mcp

vergabe-mcp

by jocks-studio

vergabe-mcp

CI npm

oeffentlichevergabe.de 向けのMCPサーバーです。これはドイツ連邦政府の公共調達ポータルです。ドイツではすべての公共調達がここに公開されており、バルクのオープンデータエクスポートも提供されていますが、そのエクスポートは1日遅れ、日次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で1つの告知を取得します。キュレーションされた summary(デフォルト)またはそのままの domain JSON、eforms XML、ocds JSON で取得できます。

search_tenders_raw

ネイティブの SELECT/FROM/WHERE/PAGE/ORDER DSL をそのまま渡して、生の結果を返します。キュレーションツールでは表現できないものに対応します。

lookup_code

CPVまたはNUTSコードを、ドイツ語または英語の説明に解決します。

get_export_url

日次または月次のバルクオープンデータエクスポートURLを、注意事項付きで生成します。

これら5つはすべて読み取り専用です。サーバーは何も書き込まず、ディスクに保存せず、認証情報も保持しません。

リソース。 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年8月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