vergabe-mcp

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

ツール

これら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。