MCP Unhcr

🚀 UNHCR人口数据MCPサーバー

このMCP（モデルコンテキストプロトコル）サーバーは、標準化されたインターフェースを通じて、国連難民高等弁務官事務所（UNHCR）の人口データへのアクセスを提供します。AIエージェントが国連難民高等弁務官事務所の難民人口統計データベースを、出身国、避難受け入れ国、および年で絞り込んで照会できるようにします。

✨ 主な機能

• 出身国、避難受け入れ国、および年で総人口データを照会する
• 特定の出身国と避難受け入れ国の難民/庇護申請者の数を取得する
• 出身国と避難受け入れ国の統計データを含む国の概要にアクセスする
• 年別の世界の難民統計情報を表示する

📦 インストール

依存関係

• Python 3.8以上
• pipまたはその他のPythonパッケージマネージャー

セットアップ

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

pip install -r requirements.txt

💻 使用例

ローカルでの実行

開発モードでサーバーをローカルで実行するには、以下のコマンドを実行します。

python app.py

これにより、MCPサーバーの開発モードが起動し、MCPインスペクターまたはその他のMCPクライアントを使用してサーバーとやり取りできます。

Smithery.aiへのデプロイ

このサーバーは、MCPサーバーをホストするプラットフォームであるSmithery.aiにデプロイするように構成されています。

1. サーバーをSmitheryに追加する（または既にリストされているサーバーを申し込む）
2. サーバーのページで「デプロイ」をクリックする

📚 詳細ドキュメント

APIエンドポイント

このサーバーは、国連難民高等弁務官事務所の人口APIとやり取りします。

https://api.unhcr.org/population/v1/population/

照会パラメーター

• cf_type：常に"ISO"に設定する
• coo：出身国の絞り込み（ISO 3文字の国コード、複数の場合はカンマ区切り）
• coa：避難受け入れ国の絞り込み（ISO 3文字の国コード、複数の場合はカンマ区切り）
• year：年の絞り込み（複数の年をカンマ区切り）

MCPツール

get_population_data

国連難民高等弁務官事務所からの生の人口データを取得し、必要に応じてフィルタリングできます。 パラメーター：

• coo（オプション）：出身国の絞り込み（ISO 3文字のコード、複数の場合はカンマ区切り）
• coa（オプション）：避難受け入れ国の絞り込み（ISO 3文字のコード、複数の場合はカンマ区切り）
• year（オプション）：年の絞り込み

get_refugee_count

特定の出身国の難民の数を取得します。 パラメーター：

• coo：出身国（ISO 3文字のコード）
• coa（オプション）：避難受け入れ国の絞り込み（ISO 3文字のコード）
• year（オプション）：年の絞り込み

get_asylum_count

特定の避難受け入れ国の庇護統計データを取得します。 パラメーター：

• coa：避難受け入れ国（ISO 3文字のコード）
• year（オプション）：年の絞り込み

MCPリソース

unhcr://countries

国のリストとそのISOコードを取得します。

unhcr://stats/{year}

特定の年の世界の難民統計情報を取得します。 パラメーター：

• year：統計データを取得する年

unhcr://country/{country_code}

特定の国の概要を取得し、出身国と避難受け入れ国の統計データを表示します。 パラメーター：

• country_code：ISO 3文字の国コード

📄 ライセンス

MIT

謝辞

このプロジェクトは、国連難民高等弁務官事務所の難民人口統計データベースのデータを使用しています。