AI导哈

世界银行数据查询服务

基于世界银行开放数据API的模型上下文协议服务，提供全球经济社会发展数据的查询能力。

  • by tianyuio
  • JavaScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 tianyuio/worldbank-mcp

使用说明

世界银行MCP🌐

基于世界银行开放数据API的世界银行模型上下文协议服务，为全球经济和社会发展数据提供查询功能。

📋 特性

  • ✅ 国家信息查询
  • ✅ 指标搜索（教育、健康、环境等）
  • ✅ 经济数据查询（GDP、通货膨胀、失业等）
  • ✅ 社会发展数据查询（人口、预期寿命、互联网使用等）
  • ✅ 教育数据查询（识字率、入学率等）
  • ✅ 健康和营养数据查询（医院、免疫、艾滋病毒流行率、营养不良等）
  • ✅ 实时世界银行API集成
  • ✅ 模型上下文协议兼容性

📦 安装

使用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"
    }
  }
}

直接使用节点运行：

{
  "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 人均国内生产总值 当前美元
GNI 国民总收入 当前美元
GNI_PER_PITA 人均国民生产总值 Current US$
EXPORTS_GDP 商品和服务出口 GDP的百分比
FDI_NET 外国直接投资，净流入 当前美元
通货膨胀率
失业率占总劳动力的百分比

社会指标

指标代码 说明 单位
人口 总人口 人
预期寿命 出生时预期寿命 年
出生率 出生率 每1000人
死亡率 死亡率 每1000人
INTERNET_USERS 互联网用户 占人口的百分比

教育指标

指标代码 说明 单位
识字率 识字率 15岁及以上人口的百分比
学校入学率 小学入学率 %
完成学业 小学毕业率 相关年龄组的百分比
教师_小学 小学教师 计数
教育支出 政府教育支出 GDP的百分比

健康和营养指标

指标代码 说明 单位
健康_支出 当前健康支出 GDP的百分比
医生 医生 每1000人
医院床位数 每1000人
免疫接种 麻疹免疫接种 12-23个月儿童的百分比
艾滋病毒流行率 艾滋病毒流行率 15-49岁人口的百分比
营养不良 营养不良患病率 人口百分比
结核病 结核病发病率 每10万人

常见国家代码

国家 代码 国家 代码
中国 中国 美国 美国
日本 日本 德国 德国
英国 英国 法国 法国
印度 IN 巴西 BR
俄罗斯 俄罗斯 澳大利亚 澳大利亚

项目结构

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 -类型安全开发语言
  • 模型上下文协议SDK -MCP协议实现
  • 阿西奥斯 -HTTP客户端
  • 萨德 -数据验证
  • 指挥官 -命令行工具

API终点

项目使用世界银行开放数据API：

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

许可证

该项目根据 MIT许可证 -看看 许可证 文件以获取详细信息。

相关 MCP