ecb-mcp

ecb-mcp

面向 AI Agent 的欧洲中央银行数据。在 Claude、Cursor、Windsurf 或任何 MCP 客户端中直接获取 ECB 的汇率、利率、收益率曲线、通胀、货币供应量及 100 多个其他数据集。

无需 API 密钥。无需注册。无需配置。只需运行 npx ecb-mcp。

为什么选择 ecb-mcp

ECB 通过免费的公共 API 发布 100 多个统计数据集，包括 40 多种货币的汇率、主要利率、收益率曲线、HICP 通胀、货币总量、银行统计数据等。

但该 API 使用的是 SDMX，这种格式很少有人能记住。要获取单个数字，你就得先了解数据流 ID、维度键结构和查询语法。

ecb-mcp 会将自然语言问题转换为正确的 SDMX 查询。你的 AI Agent 只需询问“当前 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： Settings > MCP Servers
• Windsurf： ~/.windsurf/config.json

你可以询问什么

安装后，只需用自然语言向 AI Agent 提问：

“当前 EUR/USD 汇率是多少？”

“显示自 2022 年以来 ECB 利率的变化”

“欧元区通胀率是多少？”

“按 ECB 汇率将 5000 USD 兑换成 GBP”

“欧元区 10 年期政府债券收益率是多少？”

“过去一年 M3 货币供应量增长了多少？”

“有哪些关于银行贷款的 ECB 数据集？”

“解释 EXR 数据集的结构”

工具

get_exchange_rates

40 多种货币的欧元参考汇率。支持日度、月度或年度数据。欧洲机构和企业使用的正是这些汇率。

"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

按关键词搜索全部 100 多个 ECB 统计数据集。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 Agent 的自然语言问题转换为针对 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 元数据，让你的 Agent 无需了解 SDMX 即可探索全部 100 多个数据集。

许可证

MIT