MCP Compras.gov.br

Сервер MCP, объединяющий в одном пакете публичные API экосистемы Compras.gov.br, предназначенный для аналитиков и специалистов в области планирования закупок и исполнения контрактов.

Поддерживает разработку:

• Предварительных технических исследований (ETP)

• Технических заданий (TR)

• Исследования цен по стандарту IN SEGES/ME 65/2021

• Проверки санкций в отношении поставщиков (CEIS, CNEP, CEAF)

• Анализа протоколов регистрации цен (ARP) для присоединения (carona)

• Межведомственного бенчмаркинга через Национальный портал государственных закупок (PNCP)

Охваченные API (v1)

⚠️ Операционные замечания

• Семейство /modulo-uasg/* не работает в upstream Dados Abertos: подтверждено прямым зондированием в мае 2026 г. — 1_consultarUasg, 2_consultarOrgao и варианты CSV возвращают HTTP 404 ("Resource not found"), несмотря на то, что они перечислены в официальном swagger. Ошибка сервера SEGES, не подлежащая исправлению через MCP. 5 затронутых инструментов (compras_uasg_listar/_consultar/_buscar + compras_orgao_listar/_consultar) обнаруживают 404 и возвращают обучающую полезную нагрузку с альтернативами: compras_pncp_orgao_unidades(cnpj) для разрешения подразделений по CNPJ (стабильно, может занять 10-30 с), или compras_contrato_comprasnet_por_uasg(uasg) для вывода списка UG с действующими контрактами.

• Фильтр UASG в /modulo-legado/*: в торгах и тендерах подтверждена ошибка Hibernate в upstream — swagger документирует co_uasg/uasg, но атрибут отсутствует в модели представления. Параметры удалены из инструментов compras_legado_pregoes_listar и compras_legado_licitacoes_listar; для фильтрации по UASG выполняйте фильтрацию на стороне клиента по возвращаемым данным.

• Portal da Transparência (CGU): сервер CGU защищен AWS WAF "Human Verification", который может блокировать вызовы API даже с действительным ключом (HTTP 405 + HTML-страница). Когда это происходит, все инструменты compras_sancao_* + составной compras_checar_sancoes_fornecedor

  • ветви санкций в compras_perfil_fornecedor_completo вернут ошибку. Это проблема upstream — исправление на стороне MCP невозможно.

• Comprasnet /api/contrato/ug/{uasg}: конечная точка не поддерживает пагинацию и возвращает полный список в одном ответе (может превышать 1 МБ). Инструмент compras_contrato_comprasnet_por_uasg применяет разбиение на стороне клиента с кэшированием полной полезной нагрузки, чтобы не перегружать LLM.

• Неисправный текстовый поиск CATMAT: фильтр descricao (и варианты nome, termo, q) из /modulo-material/4_consultarItemMaterial возвращает всю вселенную CATMAT (~340 тыс. позиций). Используйте структурные фильтры через compras_catmat_listar_grupos → _listar_classes → _buscar с codigo_grupo/codigo_classe. Инструмент выдает _aviso_filtro при обнаружении всей вселенной.

Related MCP server: narajangteo-pro

Установка

Desktop Extension (.mcpb) — рекомендуется для Claude Desktop

python build_mcpb.py     # gera dist/compras.mcpb
open dist/compras.mcpb   # Claude Desktop instala

Локальная (разработка)

uv sync
uv run compras-mcp

Удаленная (Railway через Docker)

railway login && railway link
railway add redis                                # cache compartilhado
railway variables --set "TRANSPARENCIA_API_KEY=..."
railway up
railway domain                                   # https://mcp-compras.up.railway.app/mcp

Конфигурация

Бесплатная регистрация ключа Transparência: https://api.portaldatransparencia.gov.br/api-de-dados/cadastrar-email

Смотрите .env.example для всех настраиваемых переменных (таймауты, TTL кэша, базовые URL).

Инструменты (всего 85)

Сгруппированы по функциональным областям:

Полный список находится в manifest.json или через tools/list в MCP Inspector.

Типовые потоки

ETP для закупки эргономичных кресел:

1. compras_catmat_buscar с termo="cadeira ergonomica" → получить codigo_item_catalogo

2. compras_pesquisar_precos_para_etp (составной) с tipo="material" → медиана/среднее/стандартное отклонение + отбраковка IQR

3. compras_pgc_por_catalogo для просмотра того, что другие органы планируют купить

4. compras_arp_listar с apenas_vigentes=True → действующие протоколы для возможного присоединения

Анализ поставщика перед утверждением:

1. compras_perfil_fornecedor_completo (составной) с CNPJ — один вызов возвращает регистрацию + санкции + действующие контракты

Инвентаризация контрактов, подлежащих продлению:

1. compras_contratos_listar_por_fim_vigencia с ближайшей data_fim_vigencia

2. Для каждого релевантного контракта: compras_contrato_historico_aditivos, compras_contrato_ocorrencias

Внутренние стандарты

• Стандартный конверт инструментов listar_*: {resultado, _pagina_atual, _total_paginas, _total_registros, _proxima_pagina, _cache_hit, _latency_ms}.

• SSoT описаний: описания параметров находятся в src/compras_mcp/schemas.py; инструменты читают их через _helpers.desc(Model, "campo"). Тест в tests/test_server.py обнаруживает расхождения.

• LGPD: CPF маскируются как 123.***.***-45; настройка с помощью INCLUIR_CPF_COMPLETO=true. Затронутые инструменты включают _aviso_lgpd в полезную нагрузку.

• Кэш: TTL+LRU в памяти (по умолчанию) или Redis при установленном REDIS_URL. Каждый домен имеет свой префикс (CATALOGO, PRECOS, ATAS и т.д.) — настраивается через CACHE_<PREFIX>_TTL и CACHE_<PREFIX>_MAX_SIZE.

• Даты: 3 формата в зависимости от API (YYYY-MM-DD, yyyyMMdd, YYYY-MM-DD HH:mm:ss) прозрачно преобразуются с помощью format_date(value, flavor).

• Фреймворк: FastMCP 2.x. Транспорт определяется по PORT — присутствует → HTTP на 0.0.0.0:$PORT, отсутствует → stdio.

Статус

v0.2.0 — 85 зарегистрированных инструментов, готовых к сквозному тестированию с Claude Desktop и Railway.