worldbank-mcp

World Bank MCP 🌐

基于 World Bank Open Data API 的 World Bank Model Context Protocol 服务，可查询全球经济和社会发展数据。

📋 功能

• ✅ 国家信息查询
• ✅ 指标搜索（教育、健康、环境等）
• ✅ 经济数据查询（GDP、通货膨胀、失业率等）
• ✅ 社会发展数据查询（人口、预期寿命、互联网使用情况等）
• ✅ 教育数据查询（识字率、学校入学率等）
• ✅ 健康与营养数据查询（医院、免疫接种、HIV 感染率、营养不良等）
• ✅ 实时接入 World Bank API
• ✅ 兼容 Model Context Protocol

📦 安装

使用 npm 全局安装

npm install -g worldbank-mcp

使用 npx 即时运行

npx worldbank-mcp

💻 在 MCP 客户端中使用

若要在兼容 MCP 的客户端（如 Claude Desktop、Cursor、Cherry Studio 等）中使用此服务，需要按如下方式进行配置：

配置示例：

如果已全局安装，请使用 npm 运行：

{
  "mcpServers": {
    "worldbank-mcp": {
      "name": "World Bank Data",
      "command": "worldbank-mcp",
      "description": "World Bank Open Data MCP Server"
    }
  }
}

使用 npx 即时运行：

{
  "mcpServers": {
    "worldbank-mcp": {
      "name": "World Bank Data",
      "command": "npx",
      "args": ["worldbank-mcp"],
      "description": "World Bank Open Data MCP Server"
    }
  }
}

直接使用 node 运行：

{
  "mcpServers": {
    "worldbank-mcp": {
      "name": "World Bank Data",
      "command": "node",
      "args": ["path/to/worldbank-mcp/build/index.js"],
      "description": "World Bank Open Data MCP Server"
    }
  }
}

将 path/to/ 替换为项目目录的实际路径。

🔧 MCP 工具

1. 获取国家列表

{
  "name": "get-countries",
  "description": "Get all countries supported by World Bank",
  "parameters": {
    "region": "Filter by region (optional)",
    "incomeLevel": "Filter by income level (optional)"
  }
}

2. 获取国家信息

{
  "name": "get-country-info", 
  "description": "Get detailed information for a specific country",
  "parameters": {
    "countryCode": "Country code (e.g.: CN, US)"
  }
}

3. 搜索指标

{
  "name": "search-indicators",
  "description": "Search for available indicators",
  "parameters": {
    "keyword": "Search keyword"
  }
}

4. 获取经济数据

{
  "name": "get-economic-data",
  "description": "Get economic data for a country",
  "parameters": {
    "countryCode": "Country code",
    "indicator": "Economic indicator (GDP, GDP_GROWTH, GDP_PER_CAPITA, GNI, GNI_PER_CAPITA, EXPORTS_GDP, FDI_NET, INFLATION, UNEMPLOYMENT)",
    "years": "Number of years to query (optional, default 10 years)"
  }
}

5. 获取社会发展数据

{
  "name": "get-social-data",
  "description": "Get social development data for a country", 
  "parameters": {
    "countryCode": "Country code",
    "indicator": "Social indicator (POPULATION, LIFE_EXPECTANCY, BIRTH_RATE, DEATH_RATE, INTERNET_USERS)",
    "years": "Number of years to query (optional, default 10 years)"
  }
}

6. 获取教育数据

{
  "name": "get-education-data",
  "description": "Get education data for a country", 
  "parameters": {
    "countryCode": "Country code",
    "indicator": "Education indicator (LITERACY_RATE, SCHOOL_ENROLLMENT, SCHOOL_COMPLETION, TEACHERS_PRIMARY, EDUCATION_EXPENDITURE)",
    "years": "Number of years to query (optional, default 10 years)"
  }
}

7. 获取健康与营养数据

{
  "name": "get-health-data",
  "description": "Get health and nutrition data for a country", 
  "parameters": {
    "countryCode": "Country code",
    "indicator": "Health indicator (HEALTH_EXPENDITURE, PHYSICIANS, HOSPITAL_BEDS, IMMUNIZATION, HIV_PREVALENCE, MALNUTRITION, TUBERCULOSIS)",
    "years": "Number of years to query (optional, default 10 years)"
  }
}

📖 支持的指标

经济指标

指标代码	描述	单位
GDP	国内生产总值	当前美元
GDP_GROWTH	GDP 增长率	年百分比
GDP_PER_CAPITA	人均 GDP	当前美元
GNI	国民总收入	当前美元
GNI_PER_CAPITA	人均 GNI	当前美元
EXPORTS_GDP	货物和服务出口	占 GDP 的百分比
FDI_NET	外国直接投资净流入	当前美元
INFLATION	通货膨胀率	年百分比
UNEMPLOYMENT	失业率	占劳动力总数的百分比

社会指标

指标代码	描述	单位
POPULATION	总人口	人
LIFE_EXPECTANCY	出生时预期寿命	年
BIRTH_RATE	出生率	每千人
DEATH_RATE	死亡率	每千人
INTERNET_USERS	互联网用户	占人口的百分比

教育指标

指标代码	描述	单位
LITERACY_RATE	识字率	15 岁及以上人口的百分比
SCHOOL_ENROLLMENT	小学入学率	毛入学率百分比
SCHOOL_COMPLETION	小学完成率	相应年龄组的百分比
TEACHERS_PRIMARY	小学教师人数	人数
EDUCATION_EXPENDITURE	政府教育支出	占 GDP 的百分比

健康与营养指标

指标代码	描述	单位
HEALTH_EXPENDITURE	当前卫生支出	占 GDP 的百分比
PHYSICIANS	医生	每千人
HOSPITAL_BEDS	医院病床	每千人
IMMUNIZATION	麻疹免疫接种率	12 至 23 个月儿童的百分比
HIV_PREVALENCE	HIV 感染率	15 至 49 岁人口的百分比
MALNUTRITION	营养不足发生率	占人口的百分比
TUBERCULOSIS	结核病发病率	每 10 万人

常见国家代码

国家	代码	国家	代码
中国	CN	美国	US
日本	JP	德国	DE
英国	GB	法国	FR
印度	IN	巴西	BR
俄罗斯	RU	澳大利亚	AU

项目结构

worldbank-mcp/
├── src/
│   ├── index.ts      # Main entry file
│   └── types.ts      # Type definitions
├── build/            # Compiled output
├── package.json      # Project configuration
├── tsconfig.json     # TypeScript configuration
└── README.md         # Documentation

技术栈

• TypeScript - 类型安全的开发语言
• Model Context Protocol SDK - MCP 协议实现
• Axios - HTTP 客户端
• Zod - 数据验证
• Commander - 命令行工具

API 端点

项目使用 World Bank Open Data API：

• 基础 URL：https://api.worldbank.org/v2
• 国家数据：/countries
• 指标数据：/indicators
• 国家指标数据：/country/{code}/indicator/{id}

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。