ecb-mcp

ecb-mcp

AI エージェント向けの欧州中央銀行データです。為替レート、金利、イールドカーブ、インフレ、マネーサプライなど、ECB の 100 種類以上のデータセットを Claude、Cursor、Windsurf、その他の MCP クライアントで直接利用できます。

API キーも登録も設定も不要です。npx ecb-mcp を実行するだけです。

理由

ECB は無料の公開 API を通じて、100 種類以上の統計データセットを公開しています。40 種類以上の通貨の為替レート、主要金利、イールドカーブ、HICP インフレ率、通貨供給量、銀行統計など、さまざまなデータを利用できます。

しかし、この API では SDMX という、ほとんどの人が覚えていない形式が使われています。数値を 1 つ取得するだけでも、データフロー ID、ディメンションキーの構造、クエリ構文を把握する必要があります。

ecb-mcp は、自然な質問を適切な SDMX クエリに変換します。AI エージェントが「現在の EUR/USD レートは？」と尋ねると、ECB の最新データからわかりやすい回答を取得できます。SDMX の知識は必要ありません。

クイックスタート

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "ecb": {
      "command": "npx",
      "args": ["-y", "ecb-mcp"]
    }
  }
}

これだけです。API キー、環境変数、アカウント作成は不要です。

この設定の追加先

• Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）
• Claude Code： claude mcp add ecb-mcp -- npx -y ecb-mcp
• Cursor： 設定 > MCP サーバー
• Windsurf： ~/.windsurf/config.json

質問できること

インストールしたら、自然な言葉で AI エージェントに質問するだけです。

「現在の EUR/USD 為替レートは？」

「2022 年以降の ECB の金利変更を表示して」

「ユーロ圏のインフレ率は？」

「ECB のレートで 5000 USD を GBP に換算して」

「ユーロ圏の 10 年国債利回りは？」

「この 1 年間で M3 のマネーサプライはどのくらい増えた？」

「銀行融資に関する ECB のデータセットには何がある？」

「EXR データセットの構造を説明して」

ツール

get_exchange_rates

40 種類以上の通貨に対する EUR の参照レートです。日次、月次、年次に対応しています。欧州の機関や企業が使用しているものと同じレートです。

"What's the EUR/USD rate?"
"Show me EUR/GBP rates for the last 30 days"
"EUR/JPY monthly averages for 2024"

get_interest_rates

ECB の主要政策金利です。市場を動かし、ユーロ圏の金融政策を左右する金利です。

"What is the current ECB deposit facility rate?"
"Show me the history of ECB rate changes"
"When did the ECB last change the main refinancing rate?"

get_yield_curve

ユーロ圏の国債イールドカーブです。AAA 格付けの国債スポットレートを 3 か月から 30 年まで取得できます。

"What's the 10-year euro area yield?"
"Show me the 2-year yield over the past 6 months"
"Compare 5Y and 10Y yields since January"

get_inflation

HICP インフレ率は、ユーロ圏の公式インフレ指標です。ユーロ圏全体または各国のデータを利用できます。

"What's the current eurozone inflation rate?"
"Germany's inflation over the past year"
"Compare inflation in France vs Spain"

get_money_supply

ユーロ圏の通貨供給量（M1、M2、M3）です。残高または前年比の伸び率を取得できます。

"What's the current M3 money supply?"
"M1 growth rate over the past year"
"How has M3 evolved since 2020?"

convert_currency

ECB の公式参照レートを使って、任意の金額を通貨間で換算します。EUR を介した換算、逆方向の換算、通貨間の換算に対応しています（例：EUR を介した三角換算による USD から GBP への換算）。

"Convert 1000 EUR to USD"
"How much is 500 GBP in JPY?"
"What was 10000 USD worth in CHF on 2025-01-15?"

search_datasets

キーワードで ECB の 100 種類以上の統計データセットを検索します。ECB が公開するのは為替レートだけではありません。銀行統計、国際収支、政府債務、決済システム、保険データなど、さまざまなデータがあります。

"What ECB datasets are about bank lending?"
"Find datasets related to government debt"
"What data does the ECB publish about payments?"

explain_dataset

ECB の任意のデータセットについて、ディメンション、有効な値、クエリ方法などの構造を確認できます。組み込みツールの対象外である 100 種類以上のデータセットを活用するための鍵となります。

"Explain the EXR dataset structure"
"What dimensions does the BSI dataset have?"
"What are the valid currency codes?"

データソース

すべてのデータは ECB Data Portal API（SDMX 2.1 REST）から直接取得しています。

• 仲介者もプロキシも介さず、欧州中央銀行の最新データを取得します
• 認証や API キーは不要です
• 為替レートは毎日 16:00 CET に更新されます
• その他のデータセットは月次、四半期など、さまざまな頻度で更新されます

設定

ecb-mcp は設定なしで動作します。任意の設定項目は次のとおりです。

環境変数	デフォルト	説明
ECB_API_URL	https://data-api.ecb.europa.eu/service	API のベース URL です。ECB API をプロキシ経由で利用する場合にのみ変更してください。
DEBUG	—	任意の値を設定すると、stderr へのデバッグログ出力が有効になります。

開発

git clone https://github.com/scka-de/ecb-mcp.git
cd ecb-mcp
npm install
npm test                      # unit tests (fixtures, no API calls)
INTEGRATION=true npm test     # integration tests (live ECB API)
npm run build                 # compile to dist/
npm run dev                   # run in dev mode
npm run lint                  # check code style

仕組み

ecb-mcp は、AI エージェントの自然言語による質問を、ECB API に対する SDMX 系列キーのクエリに変換します。たとえば、Claude が EUR/USD のレートを尋ねると、ecb-mcp は次の処理を行います。

1. SDMX キーを構築します：D.USD.EUR.SP00.A
2. https://data-api.ecb.europa.eu/service/data/EXR/D.USD.EUR.SP00.A?format=csvdata から CSV を取得します
3. 応答を解析し、読みやすく整形されたデータを返します

データセットを検索する際、ecb-mcp は ECB の構造定義エンドポイントから XML メタデータを取得して解析します。これにより、エージェントは SDMX の知識がなくても、100 を超えるすべてのデータセットを探索できます。

ライセンス

MIT