Indonesia Economic & Financial Data

idn-econ-mcp — AI エージェント向けインドネシア経済データ

インドネシアと ASEAN の経済・金融データを提供する読み取り専用 MCP サーバーです。 AI エージェント（Claude Desktop、Cursor、VS Code、その他の MCP クライアント）ですぐに利用できます。 API キー不要。無料です。

• 公式 MCP レジストリ：io.github.anYoneo/indonesia-economic-data
• Smithery：bowolime/indonesia-economic-data — https://smithery.ai/servers/bowolime/indonesia-economic-data

開発の背景

AI エージェントに 「インドネシアのインフレ率はいくらで、ベトナムと比べてどうですか？」 のような質問をすると、エージェントは推測したり、情報をでっち上げたりします。このサーバーは、スクレイピングをせずに World Bank、IMF、ECB の実際の数値を直接提供します。

利用可能なツール

ツール	用途
cari_series	キーワード（inflasi、PDB、kurs、imf）でデータ系列を検索します
ambil_series	1 つの系列（例：imf:idn:NGDP_RPCH）のデータポイントを期間で絞り込んで取得します
kurs_terkini	ルピアに対する最新為替レート：USD、EUR、SGD、CNY、JPY、MYR
banding_asean	ASEAN 6 か国の指標（inflasi、pertumbuhan、utang、…）を比較します
daftar_indikator	利用可能なすべての指標と為替ペアを一覧表示します
cek_server	データベースのステータスと内容の概要を表示します

データ範囲

• 127 系列、16.183 件の観測値、期間 1960 ～ 2031 年
• 国：インドネシア、マレーシア、タイ、ベトナム、フィリピン、シンガポール
• World Bank（実績値）：インフレ率、CPI、GDP、1 人当たり GDP、失業率、投資、農業、食料、肥料、インターネット、平均寿命、人口
• IMF WEO（実績値 + 2031 年までの予測）：インフレ率、GDP、1 人当たり GDP、実質成長率、失業率、政府債務（GDP 比）、経常収支
• IDR に対する日次為替レート（ECB）：USD、EUR、SGD、CNY、JPY、MYR

series_id のプレフィックス：wb: = World Bank、imf: = IMF WEO、fx: = ECB の為替レート。

使い方

MCP バンドル（Python のセットアップ不要）

idn-econ-mcp.mcpb をダウンロードし、MCP バンドルに対応するクライアント（Claude Desktop）で開きます。 バンドルにはサーバーとデータベースが含まれており、サイズは約 966 KB です。

stdio で手動実行

{
  "mcpServers": {
    "idn-econ": {
      "command": "python",
      "args": ["/path/ke/idn-econ-mcp/src/server.py"],
      "env": { "IDN_ECON_DB": "/path/ke/vpsrevenue.db" }
    }
  }
}

エージェントへの質問例

• 「インドネシアの 2015～2025 年のインフレ率を取得してから、ベトナムと比較してください。」
• 「IMF によると、2030 年のインドネシアの GDP 成長率予測はいくらですか？」
• 「最新の USD/IDR 為替レートはいくらで、直近 30 日間の推移はどうなっていますか？」

データベースの構築／更新

python scripts/build_db.py           # World Bank + ECB (butuh collector vps-revenue)
python scripts/collect_imf.py        # IMF WEO lewat DataMapper API (tanpa key)
python scripts/build_bundle.py       # bangun idn-econ-mcp.mcpb
python scripts/build_product.py      # bangun CSV + ZIP paket data untuk dijual
python tests/test_server.py          # 10 uji (pemanggilan langsung + handshake stdio)

データソースとライセンス

• World Bank Open Data — CC BY 4.0。帰属表示をすれば商用利用可能
• IMF World Economic Outlook（DataMapper API）— 公開データ。商用利用については IMF の条件をご確認ください
• ECB euro foreign exchange reference rates — 帰属表示をすれば再利用可能

すべての出力には atribusi 列が含まれているため、ライセンス条件を簡単に遵守できます。

制限事項（正直にお伝えします）

• World Bank／IMF の指標は年次データであり、リアルタイムではありません。最新の公表データでも、現地の状況より数か月遅れている場合があります。
• IMF データの当年より後の期間は、実績値ではなく予測値です。
• BPS は含まれていません：webapi.bps.go.id は 403（Perimeter WAF）を返し、API キーの登録が必要です。IDX も内部エンドポイントが必要です。そのため、このパッケージには World Bank／IMF より新しいインドネシアのデータソースはありません。
• 指標の範囲は daftar_indikator に登録されているものに限られます。

ライセンス

MIT（コード）。データには上記の各データソースのライセンスが適用されます。