io.github.tianyuio/worldbank-mcp
World Bank Open Data MCP Server
Ask AI about io.github.tianyuio/worldbank-mcp
Powered by Claude Β· Grounded in docs
I know everything about io.github.tianyuio/worldbank-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
| Indicator Code | Description | Unit |
|---|---|---|
| GDP | Gross Domestic Product | Current US$ |
| GDP_GROWTH | GDP growth rate | Annual % |
| GDP_PER_CAPITA | GDP per capita | Current US$ |
| GNI | Gross National Income | Current US$ |
| GNI_PER_CAPITA | GNI per capita | Current US$ |
| EXPORTS_GDP | Exports of goods and services | % of GDP |
| FDI_NET | Foreign direct investment, net inflows | Current US$ |
| INFLATION | Inflation rate | Annual % |
| UNEMPLOYMENT | Unemployment rate | % of total labor force |
Social Indicators
| Indicator Code | Description | Unit |
|---|---|---|
| POPULATION | Population, total | People |
| LIFE_EXPECTANCY | Life expectancy at birth | Years |
| BIRTH_RATE | Birth rate | per 1,000 people |
| DEATH_RATE | Death rate | per 1,000 people |
| INTERNET_USERS | Internet users | % of population |
Education Indicators
| Indicator Code | Description | Unit |
|---|---|---|
| LITERACY_RATE | Literacy rate | % of people ages 15 and above |
| SCHOOL_ENROLLMENT | School enrollment, primary | % gross |
| SCHOOL_COMPLETION | Primary completion rate | % of relevant age group |
| TEACHERS_PRIMARY | Teachers in primary education | Count |
| EDUCATION_EXPENDITURE | Government expenditure on education | % of GDP |
Health and Nutrition Indicators
| Indicator Code | Description | Unit |
|---|---|---|
| HEALTH_EXPENDITURE | Current health expenditure | % of GDP |
| PHYSICIANS | Physicians | per 1,000 people |
| HOSPITAL_BEDS | Hospital beds | per 1,000 people |
| IMMUNIZATION | Immunization, measles | % of children ages 12-23 months |
| HIV_PREVALENCE | Prevalence of HIV | % of population ages 15-49 |
| MALNUTRITION | Prevalence of undernourishment | % of population |
| TUBERCULOSIS | Incidence of tuberculosis | per 100,000 people |
Common Country Codes
| Country | Code | Country | Code |
|---|---|---|---|
| China | CN | United States | US |
| Japan | JP | Germany | DE |
| United Kingdom | GB | France | FR |
| India | IN | Brazil | BR |
| Russia | RU | Australia | AU |
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.
