MCP Unhcr

🚀 UNHCR人口數據MCP服務器

本MCP（模型上下文協議）服務器藉助標準化接口，為用戶提供對聯合國難民署（UNHCR）人口數據的訪問服務。用戶可通過該服務器，讓AI代理查詢聯合國難民署的難民人口統計數據庫，並按原籍國、庇護國和年份進行數據篩選。

🚀 快速開始

此MCP服務器可在本地開發模式下運行，也能部署到Smithery.ai平臺。下面為你詳細介紹操作步驟。

✨ 主要特性

• 支持按原籍國、庇護國和年份查詢總人口數據。
• 可獲取特定原籍國和庇護國的難民/庇護 seeker 數量。
• 能夠訪問包含原籍國和庇護國統計數據的國家概況。
• 可查看按年份劃分的全球難民統計信息。

📦 安裝指南

依賴項

• Python 3.8 或更高版本
• pip 或其他 Python 包管理器

設置

1. 克隆此倉庫。
2. 安裝依賴項：

pip install -r requirements.txt

💻 使用示例

基礎用法

在本地運行

若要在開發模式下本地運行服務器，可執行以下命令：

python app.py

此命令將啟動 MCP 服務器的開發模式，你可以使用 MCP Inspector 或其他 MCP 客戶端與服務器進行交互。

部署到 Smithery.ai

此服務器已配置為可在Smithery.ai平臺上部署，該平臺專門用於託管 MCP 服務器。部署步驟如下：

1. 將你的服務器添加到 Smithery（若服務器已列出，可直接申領）。
2. 在你的服務器頁面上點擊“部署”。

📚 詳細文檔

API 端點

此服務器與聯合國難民署人口 API 進行交互，API 地址為：

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

查詢參數

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 許可證。

致謝

該項目使用了聯合國難民署難民人口統計數據庫的數據，在此表示感謝。