mcp-brasil — ブラジル公共API統合MCPサーバー

Web

概要

MCP-Brasilは「MCP Server para 27 APIs públicas brasileiras」という説明にある通り、ブラジルの公共API群(27 API)を一元的に扱うためのPython製サーバー実装です。READMEによれば204のツール、58のリソース、47のプロンプトが集約されており、AIエージェントを政府データへ接続するユースケースを主眼としています。環境設定の雛形(.env.example)、ライセンス(MIT)、コントリビューションや変更履歴のためのドキュメントが含まれており、開発/運用のための基本的な構成を備えています。エンドユーザーや開発者が政府公開データをAIと組み合わせて活用する際の“ブリッジ”を提供するプロジェクトです。

GitHub

リポジトリの統計情報

  • スター数: 11
  • フォーク数: 1
  • ウォッチャー数: 11
  • コミット数: 30
  • ファイル数: 15
  • メインの言語: Python

主な特徴

  • ブラジル内の27の公共APIを一元化し、AIエージェントから利用可能にするAPIアグリゲーター機能。
  • Pythonベースで、環境変数管理(.env.example)やコントリビューションガイドが整備されており開発参加が容易。
  • 多数のツール/リソース/プロンプトを同梱し、AIと公的データの連携ワークフローを支援。
  • MITライセンスでオープンソース、ドキュメントやCHANGELOGによる透明な開発履歴を提供。

技術的なポイント

MCP-Brasilは「複数の公共APIをAIエージェントに接続するミドルウェア/ハブ」として機能することが主目的です。技術的には、各APIごとの認証方式やレスポンススキーマの差異を吸収するアダプター層、呼び出しの安定性を高めるための再試行・タイムアウト・レート制御、そしてAI側が扱いやすい標準化されたレスポンスフォーマットの整形処理が重要になります。本リポジトリはPythonで実装されているため、FastAPIやFlask等の軽量Webフレームワークを用いたRESTエンドポイントの提供、Pydantic等によるスキーマ検証、HTTPクライアント(requestsやhttpx)での非同期呼び出し、環境変数によるAPIキー管理といった構成が想定されます。さらに、AIエージェントと連携する観点では、APIのメタデータ(スキーマ、レート制限、更新頻度)を機械的に取得・公開することが有益で、OpenAPI仕様やドキュメントエンドポイントを備えることでエージェント側での利用が容易になります。運用面ではキャッシュ(短期キャッシュやETag)、ログと監査、障害時のフェイルオーバー設計が重要です。リポジトリ内の .github ディレクトリや CONTRIBUTING.md、CHANGELOG.mdは継続的な改善とコミュニティ参加を意識した構成であり、DockerやCIの設定があればデプロイとテストの自動化も可能です。これらを組み合わせることで、政府データを扱う際に求められる信頼性、再現性、スケーラビリティを担保できます。(約700字)

プロジェクトの構成

主要なファイルとディレクトリ:

  • .env.example: file(環境変数の雛形。APIキーやエンドポイント設定を管理)
  • .github: dir(ワークフローやIssueテンプレートなど、GitHub運用設定)
  • .gitignore: file
  • CHANGELOG.md: file(変更履歴)
  • CONTRIBUTING.md: file(コントリビューションガイド)
  • README.md: file(プロジェクト概要、導入手順、使用例)
  • LICENSE: file(MITライセンス)
  • docs/: dir(ロゴや追加ドキュメント。READMEにある画像資産はここに配置されている想定)
  • src/ or app/: dir(実装本体。APIアダプタ、ルーティング、ユーティリティ等)
  • tests/: dir(ユニット/統合テスト。存在する場合)
  • requirements.txt / pyproject.toml: file(依存管理) …他 10 ファイル

上記から、環境変数で接続情報を切り替え、GitHub Actions等でCI/CDを回す構成が取りやすいことがわかります。ドキュメントや貢献ルールが整っているため外部からの拡張やAPI追加も行いやすい設計です。

まとめ

ブラジルの公共データをAIに接続するための実用的なミドルウェア群を提供する、拡張性の高いPythonプロジェクトです。(約50字)

リポジトリ情報:

READMEの抜粋:

mcp-brasil logo

mcp-brasil

MCP Server para 27 APIs públicas brasileiras

License: MIT

204 tools · 58 resources · 47 prompts

Conecte AI agents (Claude, GPT, Copilot, etc.) a dados governamentais do Brasil — economia, legislação, transparência, judiciário, eleições, meio ambiente, saúde e mais.

**24 APIs não requerem cha…