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 クライアントでの使用方法

Claude Desktop、Cursor、Cherry Studio などの MCP 対応クライアントでこのサービスを使用するには、次のように設定します。

設定例：

グローバルにインストール済みの場合、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	1 人当たり GDP	現行米ドル
GNI	国民総所得	現行米ドル
GNI_PER_CAPITA	1 人当たり GNI	現行米ドル
EXPORTS_GDP	財・サービスの輸出	GDP 比 %
FDI_NET	外国直接投資の純流入	現行米ドル
INFLATION	インフレ率	年率 %
UNEMPLOYMENT	失業率	総労働力に占める %

社会指標

指標コード	説明	単位
POPULATION	総人口	人
LIFE_EXPECTANCY	出生時平均余命	年
BIRTH_RATE	出生率	1,000 人当たり
DEATH_RATE	死亡率	1,000 人当たり
INTERNET_USERS	インターネット利用者	人口に占める %

教育指標

指標コード	説明	単位
LITERACY_RATE	識字率	15 歳以上の人口に占める %
SCHOOL_ENROLLMENT	初等教育就学率	総就学率 %
SCHOOL_COMPLETION	初等教育修了率	該当年齢層に占める %
TEACHERS_PRIMARY	初等教育の教員数	人数
EDUCATION_EXPENDITURE	教育に対する政府支出	GDP 比 %

健康・栄養指標

指標コード	説明	単位
HEALTH_EXPENDITURE	現在の医療支出	GDP 比 %
PHYSICIANS	医師数	1,000 人当たり
HOSPITAL_BEDS	病床数	1,000 人当たり
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 ファイルをご覧ください。