MCP Compras.gov.br

ブラジル政府調達ポータルCompras.gov.brの公開APIを1つのパッケージに統合したMCPサーバー。調達計画および契約執行分野のアナリストや技術者向け。

以下の作成を支援します：

• 予備技術調査書（ETP）

• 参考仕様書（TR）

• IN SEGES/ME 65/2021基準の価格調査

• 供給者制裁確認（CEIS、CNEP、CEAF）

• 価格登録議事録（ARP）の分析（カロナ）

• 国家公共調達ポータル（PNCP）を通じた機関間ベンチマーク

対応API（v1）

⚠️ 運用上の注意

• ファミリ /modulo-uasg/* はDados Abertos上流で無効：2026年5月の直接プローブで確認済み — 1_consultarUasg、2_consultarOrgaoおよびCSVバリアントは、公式swaggerにリストされているにもかかわらずHTTP 404（"Resource not found"）を返します。MCPで修正不可能なSEGESサーバーのバグです。影響を受ける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を一覧表示します。

• /modulo-legado/*のUASGフィルター：入札および競争入札には上流で確認されたHibernateバグがあります — 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の制裁ブランチはエラーを返します。これは上流の問題であり、MCP側で修正することはできません。

• Comprasnet /api/contrato/ug/{uasg}：エンドポイントはページネーションをサポートしておらず、単一の応答で完全なリストを返します（1 MBを超える可能性があります）。ツールcompras_contrato_comprasnet_por_uasgは、完全なペイロードをキャッシュしてクライアント側でスライスし、LLMへの過負荷を防ぎます。

• CATMATテキスト検索の破損：/modulo-material/4_consultarItemMaterialのフィルターdescricao（およびバリアントnome、termo、q）は、CATMAT全体（約34万アイテム）を返します。compras_catmat_listar_grupos → _listar_classes → _buscarでcodigo_grupo/codigo_classeを使用して構造フィルターを使用してください。ツールは、全体が検出されたときに_aviso_filtroを発行します。

Related MCP server: narajangteo-pro

インストール

デスクトップ拡張（.mcpb）— Claude Desktop推奨

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

ローカル（開発）

uv sync
uv run compras-mcp

リモート（Docker経由Railway）

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

設定

トランスペアレンシーキーの無料登録：https://api.portaldatransparencia.gov.br/api-de-dados/cadastrar-email

設定可能なすべての変数（タイムアウト、キャッシュTTL、ベースURL）については、.env.exampleを参照してください。

Tools（全85）

機能ドメイン別グループ：

完全なリストはmanifest.jsonまたはMCPインスペクターのtools/listにあります。

典型的なフロー

人間工学チェアの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回の呼び出しで登録 + 制裁 + 有効な契約を返す

更新予定の契約棚卸し：

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_URLが設定されている場合はRedis。各ドメインには独自のプレフィックスがあります（CATALOGO、PRECOS、ATAS等）— CACHE_<PREFIX>_TTLおよびCACHE_<PREFIX>_MAX_SIZEで調整可能。

• 日付：APIごとに3つの形式（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でのエンドツーエンドテストの準備が整いました。