UNHCR人口数据 MCP 服务器

此 MCP (模型上下文协议) 服务器通过标准化接口提供对 UNHCR 人口数据的访问。它允许 AI 代理通过原籍国、庇护国和年份查询 UNHCR 的难民人口统计数据库。

特性

• 按原籍国、庇护国和年份查询总人口数据
• 获取特定原籍国和庇护国的难民/寻求庇护者人数
• 访问包含原籍国和庇护国统计数据的国家概况
• 查看按年份划分的全球难民统计数据

安装

前提条件

• 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. 单击服务器页面上 Smithery 部署选项卡上的“部署”

API 端点

此服务器与 UNHCR 人口 API 交互：

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

查询参数

• cf_type: 始终设置为 "ISO"
• coo: 原籍国过滤器（ISO 3 字母国家代码，多个代码用逗号分隔）
• coa: 庇护国过滤器（ISO 3 字母国家代码，多个代码用逗号分隔）
• year: 年份过滤器（多个年份用逗号分隔）

MCP 工具

get_population_data

从 UNHCR 获取原始人口数据，并可选择进行过滤。

参数：

• 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

致谢

本项目使用来自 UNHCR 难民人口统计数据库 的数据。