vergabe-mcp

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

Инструменты

Все пять инструментов доступны только для чтения; сервер ничего не записывает, ничего не хранит на диске и не хранит учётные данные.

Ресурсы. 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.