{
  "markdown": "# World Bank MCP 🌐\n\n[![npm version](https://img.shields.io/npm/v/worldbank-mcp.svg)](https://www.npmjs.com/package/worldbank-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![GitHub issues](https://img.shields.io/github/issues/tianyuio/worldbank-mcp)](https://github.com/tianyuio/worldbank-mcp/issues)\n\nWorld Bank Model Context Protocol service based on World Bank Open Data API, which provides query capabilities for global economic and social development data.\n\n## 📋 Features\n\n- ✅ Country information query\n- ✅ Indicator search (education, health, environment, etc.)\n- ✅ Economic data query (GDP, inflation, unemployment, etc.)\n- ✅ Social development data query (population, life expectancy, internet usage, etc.)\n- ✅ Education data query (literacy rate, school enrollment, etc.)\n- ✅ Health and nutrition data query (hospitals, immunization, HIV prevalence, malnutrition, etc.)\n- ✅ Real-time World Bank API integration\n- ✅ Model Context Protocol compatibility\n\n## 📦 Installation\n\n### Install globally with npm\n```bash\nnpm install -g worldbank-mcp\n```\n\n### Run instantly with npx\n```bash\nnpx worldbank-mcp\n```\n\n## 💻 Usage in MCP Clients\n\nTo use this service in MCP-compatible clients (such as Claude Desktop, Cursor, Cherry Studio, etc.), you need to configure it as follows:\n\nConfiguration example:\n\n### Run with npm if you have installed it globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"worldbank-mcp\": {\n      \"name\": \"World Bank Data\",\n      \"command\": \"worldbank-mcp\",\n      \"description\": \"World Bank Open Data MCP Server\"\n    }\n  }\n}\n```\n\n### Run instantly with npx:\n\n```json\n{\n  \"mcpServers\": {\n    \"worldbank-mcp\": {\n      \"name\": \"World Bank Data\",\n      \"command\": \"npx\",\n      \"args\": [\"worldbank-mcp\"],\n      \"description\": \"World Bank Open Data MCP Server\"\n    }\n  }\n}\n```\n\n### Run directly with node:\n\n```json\n{\n  \"mcpServers\": {\n    \"worldbank-mcp\": {\n      \"name\": \"World Bank Data\",\n      \"command\": \"node\",\n      \"args\": [\"path/to/worldbank-mcp/build/index.js\"],\n      \"description\": \"World Bank Open Data MCP Server\"\n    }\n  }\n}\n```\n\nReplace `path/to/` with the actual path to your project directory.\n\n\n## 🔧 MCP Tools\n\n### 1. Get Countries List\n```json\n{\n  \"name\": \"get-countries\",\n  \"description\": \"Get all countries supported by World Bank\",\n  \"parameters\": {\n    \"region\": \"Filter by region (optional)\",\n    \"incomeLevel\": \"Filter by income level (optional)\"\n  }\n}\n```\n\n### 2. Get Country Information\n```json\n{\n  \"name\": \"get-country-info\", \n  \"description\": \"Get detailed information for a specific country\",\n  \"parameters\": {\n    \"countryCode\": \"Country code (e.g.: CN, US)\"\n  }\n}\n```\n\n### 3. Search Indicators\n```json\n{\n  \"name\": \"search-indicators\",\n  \"description\": \"Search for available indicators\",\n  \"parameters\": {\n    \"keyword\": \"Search keyword\"\n  }\n}\n```\n\n### 4. Get Economic Data\n```json\n{\n  \"name\": \"get-economic-data\",\n  \"description\": \"Get economic data for a country\",\n  \"parameters\": {\n    \"countryCode\": \"Country code\",\n    \"indicator\": \"Economic indicator (GDP, GDP_GROWTH, GDP_PER_CAPITA, GNI, GNI_PER_CAPITA, EXPORTS_GDP, FDI_NET, INFLATION, UNEMPLOYMENT)\",\n    \"years\": \"Number of years to query (optional, default 10 years)\"\n  }\n}\n```\n\n### 5. Get Social Development Data\n```json\n{\n  \"name\": \"get-social-data\",\n  \"description\": \"Get social development data for a country\", \n  \"parameters\": {\n    \"countryCode\": \"Country code\",\n    \"indicator\": \"Social indicator (POPULATION, LIFE_EXPECTANCY, BIRTH_RATE, DEATH_RATE, INTERNET_USERS)\",\n    \"years\": \"Number of years to query (optional, default 10 years)\"\n  }\n}\n```\n\n### 6. Get Education Data\n```json\n{\n  \"name\": \"get-education-data\",\n  \"description\": \"Get education data for a country\", \n  \"parameters\": {\n    \"countryCode\": \"Country code\",\n    \"indicator\": \"Education indicator (LITERACY_RATE, SCHOOL_ENROLLMENT, SCHOOL_COMPLETION, TEACHERS_PRIMARY, EDUCATION_EXPENDITURE)\",\n    \"years\": \"Number of years to query (optional, default 10 years)\"\n  }\n}\n```\n\n### 7. Get Health and Nutrition Data\n```json\n{\n  \"name\": \"get-health-data\",\n  \"description\": \"Get health and nutrition data for a country\", \n  \"parameters\": {\n    \"countryCode\": \"Country code\",\n    \"indicator\": \"Health indicator (HEALTH_EXPENDITURE, PHYSICIANS, HOSPITAL_BEDS, IMMUNIZATION, HIV_PREVALENCE, MALNUTRITION, TUBERCULOSIS)\",\n    \"years\": \"Number of years to query (optional, default 10 years)\"\n  }\n}\n```\n\n## 📖 Supported Indicators\n\n### Economic Indicators\n\n| Indicator Code | Description | Unit |\n|---------|------|------|\n| GDP | Gross Domestic Product | Current US$ |\n| GDP_GROWTH | GDP growth rate | Annual % |\n| GDP_PER_CAPITA | GDP per capita | Current US$ |\n| GNI | Gross National Income | Current US$ |\n| GNI_PER_CAPITA | GNI per capita | Current US$ |\n| EXPORTS_GDP | Exports of goods and services | % of GDP |\n| FDI_NET | Foreign direct investment, net inflows | Current US$ |\n| INFLATION | Inflation rate | Annual % |\n| UNEMPLOYMENT | Unemployment rate | % of total labor force |\n\n### Social Indicators\n\n| Indicator Code | Description | Unit |\n|---------|------|------|\n| POPULATION | Population, total | People |\n| LIFE_EXPECTANCY | Life expectancy at birth | Years |\n| BIRTH_RATE | Birth rate | per 1,000 people |\n| DEATH_RATE | Death rate | per 1,000 people |\n| INTERNET_USERS | Internet users | % of population |\n\n### Education Indicators\n\n| Indicator Code | Description | Unit |\n|---------|------|------|\n| LITERACY_RATE | Literacy rate | % of people ages 15 and above |\n| SCHOOL_ENROLLMENT | School enrollment, primary | % gross |\n| SCHOOL_COMPLETION | Primary completion rate | % of relevant age group |\n| TEACHERS_PRIMARY | Teachers in primary education | Count |\n| EDUCATION_EXPENDITURE | Government expenditure on education | % of GDP |\n\n### Health and Nutrition Indicators\n\n| Indicator Code | Description | Unit |\n|---------|------|------|\n| HEALTH_EXPENDITURE | Current health expenditure | % of GDP |\n| PHYSICIANS | Physicians | per 1,000 people |\n| HOSPITAL_BEDS | Hospital beds | per 1,000 people |\n| IMMUNIZATION | Immunization, measles | % of children ages 12-23 months |\n| HIV_PREVALENCE | Prevalence of HIV | % of population ages 15-49 |\n| MALNUTRITION | Prevalence of undernourishment | % of population |\n| TUBERCULOSIS | Incidence of tuberculosis | per 100,000 people |\n\n### Common Country Codes\n\n| Country | Code | Country | Code |\n|------|------|------|------|\n| China | CN | United States | US |\n| Japan | JP | Germany | DE |\n| United Kingdom | GB | France | FR |\n| India | IN | Brazil | BR |\n| Russia | RU | Australia | AU |\n\n## Project Structure\n\n```\nworldbank-mcp/\n├── src/\n│   ├── index.ts      # Main entry file\n│   └── types.ts      # Type definitions\n├── build/            # Compiled output\n├── package.json      # Project configuration\n├── tsconfig.json     # TypeScript configuration\n└── README.md         # Documentation\n```\n\n## Technology Stack\n\n- **TypeScript** - Type-safe development language\n- **Model Context Protocol SDK** - MCP protocol implementation\n- **Axios** - HTTP client\n- **Zod** - Data validation\n- **Commander** - Command-line tool\n\n## API Endpoints\n\nProject uses World Bank Open Data API:\n- Base URL: `https://api.worldbank.org/v2`\n- Country data: `/countries`\n- Indicator data: `/indicators`\n- Country indicator data: `/country/{code}/indicator/{id}`\n\n## License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n",
  "bytes": 7458,
  "sha": "707a7500a0283df5e11cb480abdda3ebff7186617efa1bbf38178984c47c1ae5",
  "repo_slug": "tianyuio/worldbank-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tianyuio_worldbank_mcp_e69777c4/readme"
}