Skip to main content
Glama
vergabe-mcp

vergabe-mcp

by jocks-studio

vergabe-mcp

CI npm

MCP-сервер для oeffentlichevergabe.de — федерального портала государственных закупок Германии. Германия публикует все государственные тендеры на этом портале и предоставляет массовый экспорт открытых данных, но этот экспорт задерживается на день, поставляется в виде ежедневных ZIP-архивов и не поддерживает фильтрацию — вы скачиваете всё и разбираетесь самостоятельно. Собственный поисковый API портала умеет фильтровать (по коду CPV, региону, срокам, флагу eForms «подходит для фрилансеров») и актуален в момент публикации извещения, но он не документирован. Этот сервер оборачивает его, так что любой MCP-клиент может искать в живом потоке с реальными фильтрами и получать извещение в доменной модели портала, в XML eForms или в 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

Одно извещение по идентификатору, в виде подобранного summary (по умолчанию) или дословного domain JSON, eforms XML или ocds JSON.

search_tenders_raw

Родной DSL SELECT/FROM/WHERE/PAGE/ORDER, передаётся насквозь и возвращается как есть — для всего, что не выражается через подготовленный инструмент.

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) выполняет поиск с флагами для фрилансеров/самозанятых, а затем проводит модель через сортировку кандидатов: человеко-дни, скрытые в описании, является ли ближайший срок крайним сроком запроса на участие или самим предложением, и тот факт, что пустое поле значения ничего не значит. Эти знания для сортировки поставляются в виде подсказки, а не в виде кода оценки, чтобы вы могли с ней спорить.

Пример

Вы: Найди открытые ИТ-тендеры, которые отмечены как подходящие для фрилансеров.

Модель вызывает 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 превращает их в PR релиза в main — слияние этого PR создаёт тег релиза, записывает журнал изменений, публикует в npm и прикрепляет архив к релизу на 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