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-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

도구

다섯 가지 모두 읽기 전용입니다. 서버는 아무것도 쓰지 않으며, 디스크에 저장하지 않고, 자격 증명을 보유하지 않습니다.

리소스. 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.