🚀 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 许可证。

致谢

该项目使用了联合国难民署难民人口统计数据库的数据，在此表示感谢。