io.github.tianyuio/worldbank-mcp

World Bank MCP 🌐

World Bank Model Context Protocol service based on World Bank Open Data API, which provides query capabilities for global economic and social development data.

📋 Features

• ✅ Country information query
• ✅ Indicator search (education, health, environment, etc.)
• ✅ Economic data query (GDP, inflation, unemployment, etc.)
• ✅ Social development data query (population, life expectancy, internet usage, etc.)
• ✅ Education data query (literacy rate, school enrollment, etc.)
• ✅ Health and nutrition data query (hospitals, immunization, HIV prevalence, malnutrition, etc.)
• ✅ Real-time World Bank API integration
• ✅ Model Context Protocol compatibility

📦 Installation

Install globally with npm

npm install -g worldbank-mcp

Run instantly with npx

npx worldbank-mcp

💻 Usage in MCP Clients

To use this service in MCP-compatible clients (such as Claude Desktop, Cursor, Cherry Studio, etc.), you need to configure it as follows:

Configuration example:

Run with npm if you have installed it globally:

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

Run instantly with npx:

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

Run directly with 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"
    }
  }
}

Replace path/to/ with the actual path to your project directory.

🔧 MCP Tools

1. Get Countries List

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

2. Get Country Information

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

3. Search Indicators

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

4. Get Economic Data

{
  "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. Get Social Development Data

{
  "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. Get Education Data

{
  "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. Get Health and Nutrition Data

{
  "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)"
  }
}

📖 Supported Indicators

Economic Indicators

Social Indicators

Education Indicators

Health and Nutrition Indicators

Common Country Codes

Project Structure

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

Technology Stack

• TypeScript - Type-safe development language
• Model Context Protocol SDK - MCP protocol implementation
• Axios - HTTP client
• Zod - Data validation
• Commander - Command-line tool

API Endpoints

Project uses World Bank Open Data API:

• Base URL: https://api.worldbank.org/v2
• Country data: /countries
• Indicator data: /indicators
• Country indicator data: /country/{code}/indicator/{id}

License

This project is licensed under the MIT License - see the LICENSE file for details.