Development Indicators MCP

Development Indicators MCP

国際開発の公式指標に特化した、出典情報を優先する Model Context Protocol ゲートウェイです。

ホスト型 MCP エンドポイント： https://indicatorsmcp.impactengines.ai/mcp

このプロジェクトは、世界銀行、国連機関、FAO、WHO、UNICEF、ILO、DHS Program などの機関が提供する信頼できる指標を、AI エージェントが一貫したインターフェースを通じて検索・照会できるようにすることを目指しています。出典のない文章を返すのではなく、定義、単位、次元、出典コード、引用を保持します。

現在のマイルストーン

このリポジトリには、動作する垂直スライスが含まれています。

• Streamable HTTP を使用するリモート対応の MCP サーバー。ローカルクライアント向けに stdio にも対応しています。
• API、認証、機能を記述するソースレジストリ。
• 正規化された指標および観測値のスキーマ。
• World Bank、WHO GHO、UNICEF、FAOSTAT、ILOSTAT、IMF、UNSD SDG、 UNESCO UIS、OECD、ADB のライブアダプター。
• バックグラウンドでのトークン更新を行わない、必要に応じた FAOSTAT 認証。
• FAOSTAT のドメイン、国、項目、要素の動的な検出。
• エイリアス、照合理由、取得状態のシグナル、上限付きのプロバイダー待機、15 分間のクエリキャッシュを備えた、重み付けされたライブカタログ検索。
• 部分的な失敗を許容する比較、型付きエラー、ネイティブの構造化出力、簡潔な応答。
• 構造化された未解決国エラーを伴う、部分成功の地理情報解決。
• 正規化された ILOSTAT 頻度ラベルと FAOSTAT 次元ランキングの根拠情報。
• 国名の解決、メタデータの確認、観測値の取得を行うツール。
• 正規化およびソースの動作を対象とする単体テスト。

これはパブリックベータであり、本番用の統計サービスではありません。ホスト型インスタンスは評価用に提供されています。また、自分でコピーを実行またはデプロイすることもできます。

MCP ツール

• list_sources(topic=None)
• get_source_setup(source_id)
• search_indicators(query, source_ids=None, limit=10)
• get_indicator_metadata(series_ref)
• get_observations(series_ref, country_codes, start_year=None, end_year=None, latest_only=False, include_original=False)
• compare_observations(series_refs, country_codes, ...)
• find_microdata(query, country=None)
• faostat_list_domains(limit=50, cursor=0, group_code=None, status=None, include_archived=False)
• faostat_search_dimension(dataset, dimension, query, limit=20, cursor=0)
• resolve_geographies(names_or_codes)

系列参照は source_id:series_code の形式を使用します。例：world_bank:SP.POP.TOTL。 観測値の呼び出しでは、GHA や KEN などの ISO 3166-1 alpha-3 コードを受け付けます。プロンプトに国名が含まれる場合は、 resolve_geographies を使用してください。複数の項目を含むリクエストでは、リクエスト全体を失敗させるのではなく、 resolved と unresolved の両方の項目を返します。

ローカル開発

py -3.11 -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
pytest
development-data-mcp

macOS または Linux の場合は、source .venv/bin/activate で環境を有効にします。

ライブソースのスモークベンチマークを実行するには、次を実行します。

python -m benchmarks.run

FAOSTAT_USER と FAOSTAT_PASSWORD が設定されるまで、FAOSTAT のチェックはスキップされます。公開ソースのチェックはすべて、認証情報なしで実行されます。

デフォルトのトランスポートは stdio です。ホスト型に相当する HTTP エンドポイントを実行するには、次を実行します。

$env:MCP_TRANSPORT = "streamable-http"
$env:MCP_HOST = "127.0.0.1"
$env:MCP_PORT = "8000"
development-data-mcp

MCP エンドポイントは /mcp で公開されます。本番環境へのデプロイでは、アプリケーション層またはゲートウェイ層で HTTPS、認証、レート制限、監査ログを追加する必要があります。

Codex へのインストール

ホスト型サービスでは Streamable HTTP を使用します。

codex mcp add development-indicators --url https://indicatorsmcp.impactengines.ai/mcp
codex mcp list

追加後、Codex を再起動し、/mcp を使ってサーバーとそのツールが利用可能であることを確認してください。同じ Codex ホスト上では、Codex CLI、IDE 拡張機能、ChatGPT デスクトップアプリで同じ MCP 設定が共有されます。

同等の ~/.codex/config.toml 設定：

[mcp_servers.development-indicators]
url = "https://indicatorsmcp.impactengines.ai/mcp"
startup_timeout_sec = 30
tool_timeout_sec = 180

テスト用プロンプトの例：Using Development Indicators, find an official maize production series from FAOSTAT and retrieve 2020–2023 observations for Uganda and Kenya, preserving units, flags and citations.

Cloudflare へのデプロイ

このリポジトリには、Cloudflare Worker と Container の設定が含まれています。公開 HTTPS リクエストを、テスト済みの同じ Python イメージにルーティングします。MCP エンドポイントは引き続き /mcp です。本番環境へのデプロイでは、まず専用の workers.dev ホスト名を使用し、その後、クライアントでの検証を終えてからカスタムドメインを割り当ててください。

npm install
npm run deploy

別の Worker 名またはホスト名でデプロイするには、wrangler.jsonc の name と routes を編集してください。workers.dev エンドポイントのみを使用する場合は、routes ブロックを削除してください。デプロイコマンドを実行する前に、独自の Cloudflare アカウントで Wrangler を認証してください。このリポジトリには Impact Engines の認証情報は含まれていません。

任意のプロバイダー認証情報は、コミットせずに Worker に追加できます。

npx wrangler secret put FAOSTAT_USER
npx wrangler secret put FAOSTAT_PASSWORD
npx wrangler secret put UN_POPULATION_TOKEN

デプロイのアーキテクチャ、検証チェックリスト、Cloudflare 以外で Docker を使用する手順については、docs/deployment.md を参照してください。

Docker で実行する

docker build -t development-data-mcp .
docker run --rm -p 8000:8000 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=8000 \
  development-data-mcp

エンドポイントは http://localhost:8000/mcp で利用できます。パブリックインターネットに公開する前に、HTTPS と適切なアクセス制御の背後に配置してください。

コントリビューション

Issue とプルリクエストを歓迎します。変更を提出する前に、ruff check .、pytest、npm run typecheck を実行してください。開発ワークフローの全容については CONTRIBUTING.md を、脆弱性を非公開で報告する方法については SECURITY.md を参照してください。

Cloudflare Containers の利用には Workers の有料プランが必要です。FAOSTAT の認証情報を設定する場合は、コミットせずに Wrangler のシークレットとして保存してください。

アーキテクチャ

AI client
   |
Remote MCP gateway
   |
Metadata registry and source router
   |
Provider adapters (REST / SDMX / OData / specialist)
   |
Official publisher APIs

最初は、メタデータと小規模なリクエストキャッシュのみをローカルに保存してください。観測値は公式ソースから取得し、元のソース識別子を保持したまま共通の形式で返します。

予定しているソースの順序

現在有効な観測値コネクター：World Bank Indicators、WHO GHO、UNICEF SDMX、FAOSTAT、ILOSTAT、IMF DataMapper、UNSD SDG、UNESCO UIS、OECD SDMX、ADB SDMX。UN Population の指標検索は有効ですが、観測値エンドポイントの利用にはポータルが発行するベアラートークンが必要です。DHS、MICS、IPUMS、World Bank Microdata Library は、観測値 API ではなく、カタログ検索の連携機能として引き続き提供されます。

安全性と統計的整合性

• MCP が値を捏造したり推測したりすることはありません。
• 類似する指標を黙って統合することはありません。
• プロバイダーのコードと正規 URL は保持されます。
• メタデータで判別できる場合は、観測値、調査に基づく推定値、モデル推定値、予測値を明記する必要があります。
• マイクロデータのカタログ検索ができても、制限付きファイルのダウンロードが許可されるわけではありません。
• 大量の結果はモデルのコンテキストに直接入れず、エクスポートしてください。

ライセンス

このソフトウェアは MIT License の下で公開されています。上流データには、各公開者の利用規約、ライセンス、帰属表示要件が適用されます。