IMF Data MCP

IMF Data MCP

imfp と data.imf.org の IMF SDMX API を基盤とする、IMF 経済データ用の Model Context Protocol サーバーです。

v0.2.0 — 破壊的変更： 旧サーバーが呼び出していた dataservices.imf.org は、IMF によって 2025 年に廃止されました。 その結果、すべてのリクエストがタイムアウトしていました。 このバージョンでは、現在の data.imf.org SDMX 3.0 API を対象とし、積極的にメンテナンスされている imfp に移行します。

---

インストール

uv を使用する場合（推奨）

uvx --from git+https://github.com/c-cf/imf-data-mcp imf-data-mcp

pip を使用する場合

pip install git+https://github.com/c-cf/imf-data-mcp.git

---

Claude Desktop の設定

{
  "mcpServers": {
    "imf": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/c-cf/imf-data-mcp", "imf-data-mcp"]
    }
  }
}

または、pip でインストールした場合：

{
  "mcpServers": {
    "imf": {
      "command": "imf-data-mcp"
    }
  }
}

---

利用可能なツール

ツール	説明
imf_list_databases	約 155 件の IMF データベースとその ID を一覧表示します
imf_search_databases	キーワード（例："inflation"、"trade"）でデータベースを絞り込みます
imf_get_parameter_defs	データベースのクエリディメンションを一覧表示します
imf_get_parameter_codes	ディメンションの有効なコードを、任意の検索条件を指定して一覧表示します
imf_fetch_data	年の範囲とディメンションのフィルターを指定して時系列データを取得します

---

一般的なワークフロー

1. imf_search_databases(keyword="consumer price")
   → CPI, CPI_WCA, ...

2. imf_get_parameter_defs(database_id="CPI")
   → country, index_type, coicop_1999, frequency, ...

3. imf_get_parameter_codes(database_id="CPI", parameter="country", search="austria")
   → AUT

4. imf_fetch_data(
       database_id="CPI",
       start_year=2015, end_year=2023,
       filters={"country": ["AUT"], "frequency": ["M"]}
   )

---

よく使われるデータベース ID

トピック	ID
消費者物価	CPI
生産者物価	PPI
国民経済計算（年次）	ANEA
国民経済計算（四半期）	QNEA
国際収支	BOP_AGG
為替レート	ER_2026_JAN_VINTAGE
商品価格	PCPS
財政モニター	FM
政府財政統計	GFS_COFOG
金融統計	MFS_CBS、MFS_MA、MFS_IR
金融健全性	FSIC
サービス貿易	ITS
SDG データ	SDG

---

レート制限

IMF API では、5 秒あたり約 10 件のリクエストが許可されています。imfp はレート制限と再試行を自動的に処理します。

---

デバッグ

npx @modelcontextprotocol/inspector imf-data-mcp

---

ライセンス

Apache 2.0