vergabe-mcp
vergabe-mcp
oeffentlichevergabe.de를 위한 MCP 서버입니다. 독일 연방 공공입찰 포털입니다. 독일은 모든 공공입찰을 이곳에 게시하며 대량의 오픈데이터 내보내기를 제공하지만, 이 내보내기는 하루가 지연되고 일별 ZIP 파일로 제공되며 필터링이 불가능합니다. 즉, 모든 것을 다운로드하여 직접 분류해야 합니다. 포털 자체 검색 API는 필터링(CPV 코드, 지역, 마감일 기간, eForms의 '프리랜서 적합' 플래그)이 가능하며 공고가 게시되는 즉시 최신 상태이지만 문서화되어 있지 않습니다. 이 서버는 이를 래핑하여 모든 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 입찰을 찾아줘.
모델은 cpv: ["72"], suitableFor: ["freelance"], onlyActive: true로 search_tenders를 호출합니다. 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