UNHCR 人口数据 MCP 服务器

此 MCP（Model Context Protocol）服务器通过标准化接口提供访问 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 三位字母国家代码，多个用逗号分隔）
• coa：庇护国过滤器（ISO 三位字母国家代码，多个用逗号分隔）
• year：年份过滤器（多个年份用逗号分隔）

MCP 工具

get_population_data

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

参数：

• coo（可选）：原籍国过滤器（ISO 三位字母代码，多个用逗号分隔）
• coa（可选）：庇护国过滤器（ISO 三位字母代码，多个用逗号分隔）
• year（可选）：年份过滤器（多个年份用逗号分隔）

get_refugee_count

获取特定原籍国的难民数量。

参数：

• coo：原籍国（ISO 三位字母代码）
• coa（可选）：庇护国过滤器（ISO 三位字母代码）
• year（可选）：年份过滤器

get_asylum_count

获取特定庇护国的庇护统计数据。

参数：

• coa：庇护国（ISO 三位字母代码）
• year（可选）：年份过滤器

MCP 资源

unhcr://countries

获取带有 ISO 代码的国家列表。

unhcr://stats/{year}

获取特定年份的全球难民统计数据。

参数：

• year：要获取统计数据的年份

unhcr://country/{country_code}

获取特定国家的概况，显示原籍国和庇护国统计数据。

参数：

• country_code：ISO 三位字母国家代码

许可证

MIT

致谢

该项目使用了来自联合国难民署难民人口统计数据数据库的数据。