Central Bank Rates (AllRatesToday)

中央银行汇率 MCP 服务 — @allratestoday/central-bank-mcp

网站：https://allratestoday.com/central-bank-rates-api/ · 托管端点（无需安装）：https://allratestoday.com/api/mcp · 文档：https://allratestoday.com/mcp/

让你的 AI 助手获取合规、税务和会计工作真正需要的官方汇率。这是一个 Model Context Protocol 服务，可让 Claude Code、Cursor、Claude Desktop、Windsurf 以及任何兼容 MCP 的客户端，通过 AllRatesToday API 获取来自 122 家中央银行和 4 家税务机关 发布的汇率——包括 ECB、Fed、日本银行、HMRC、美国财政部等。

安装后，你的助手就能回答这类问题：

• “ECB 今天公布的官方 USD/EUR 汇率是多少？”
• “这张 3 月的发票应该采用 HMRC 的哪种汇率？”
• “列出日本银行 Q1 每一天的官方汇率。”
• “比较所有公布官方 USD/LKR 汇率的中央银行。”

⚖️ 官方汇率与市场中间价

本服务返回的全部都是官方公布的汇率：由机构公布后固定，并带有该机构自己的发布日期——这是税务机关、审计师和海关要求使用的数值。它不是实时市场汇率。对于实时市场中间价（价格显示、兑换，以及任何应随市场变动的场景），请使用配套服务 @allratestoday/mcp-server。两者可能相差几个百分点——请根据使用场景选择。方法说明：allratestoday.com/official-rates-methodology。

🚀 为什么选择本服务？

• 🏛️ 122 家中央银行和 4 家税务机关——中央银行（ECB、Fed、BOJ、SNB、RBI、……）以及税务机关（HMRC、美国财政部、……），数据均来自各自发布的汇率表
• 📅 指定时点的准确性——可查询任意日期；周末和节假日会回溯至当时生效的汇率，响应还会告知适用的发布日期
• 📊 跨银行比较——一次调用即可返回某货币对在所有机构的汇率，以及最小值、最大值、中位数和价差统计
• 🧮 诚实的推算——提供 API 密钥后，若某家银行未直接公布某货币对，服务仅在该银行自己的汇率表内进行交叉计算，并标记为 derived；绝不混用不同银行的数据。无密钥时仅提供已公布的货币对及其倒数
• 🔓 无需 API 密钥即可使用——开箱即装、开箱即用；所有来源的最新已发布汇率表均可公开访问
• 🧰 六个专用工具——功能精简，便于模型正确使用
• 🔌 适用于所有支持 MCP 的环境——stdio 传输、MCP 1.x；支持 Claude Code、Cursor、Claude Desktop、Windsurf 以及任何通用宿主

🔑 获取你的 API 密钥（免费）

免费密钥支持跨央行比较、交叉货币对和公布日历——免费，无需信用卡。带日期的（历史）表格和时间序列需要付费套餐：免费密钥和试用密钥调用这些功能时会收到 403 错误。

1. 在 allratestoday.com/register 注册——只需 30 秒
2. 验证你的电子邮件
3. 从控制面板复制密钥（格式：art_live_xxxxx）
4. 在下方的配置中将其用作 ALLRATES_API_KEY

未提供密钥时，服务会在 stderr 上打印一段无密钥模式的简短说明（见下文），并继续运行——它不会退出，因为退出的 MCP 服务会破坏宿主客户端的整个配置。

🔓 无密钥模式——无需设置即可使用的功能

无需任何配置即可安装并启动、连接和响应：

工具	无密钥	可获取内容
list_central_banks	✅	所有涵盖的机构（122 家中央银行、4 家税务机关以及综合数据），来自软件包内置的目录（无覆盖日期）。
get_official_rates	✅	任意来源最新发布的表格，或其中一个已发布的货币对（或其反向货币对），并包含发布方自己的 rate_date。交叉货币对需要密钥。
带有 date 的 get_official_rates	🔑	一句话说明带日期的表格需要付费套餐。
get_official_rate_history	🔑	同上（付费套餐）。
compare_official_rates	🔑	一句话说明如何获取免费密钥。
get_publication_calendar	🔑	同上。
request_trial_key	✅	无需账户即可自行签发一个可调用 100 次、有效期 7 天的密钥，并在当前会话中启用。

无密钥模式会读取开放且经边缘缓存的 /api/open/central-bank/{bank} 端点（确切的署名措辞也会随每条响应一同提供在 attribution 字段中）。

署名。 无密钥使用时，凡是展示汇率的地方都必须提供指向 AllRatesToday 的可见链接（页脚、关于页面、README 等）。使用 API 密钥时，提供链接虽受欢迎，但并非必需。

<a href="https://allratestoday.com">Exchange rates by AllRatesToday</a>

Markdown：Exchange rates by [AllRatesToday](https://allratestoday.com)。完整措辞：https://allratestoday.com/terms/#attribution。

🧩 最简单的安装方式：Claude Code 插件

如果你使用 Claude Code，可安装插件，无需手动配置此服务——它包含两个 AllRatesToday MCP 服务、两个技能和五个斜杠命令（/rate、/convert、/official-rate、/fx-history、/add-currency-support）：

/plugin marketplace add AllRates-Today/claude-code-plugin
/plugin install allratestoday@allratestoday

以下内容仍适用于其他 MCP 客户端。

☁️ 托管端点——无需安装

相同的六个工具也作为托管的 Streamable HTTP MCP 服务运行，并与 AllRatesToday 关联服务的五个工具一同提供——托管端点共计十一个工具（此 npm 软件包本身提供六个）。将 URL 粘贴到任何支持远程 MCP 的客户端中——Claude.ai 和 Claude Desktop 连接器、ChatGPT、Cursor、VS Code、Codex、Gemini CLI：

https://allratestoday.com/api/mcp

claude mcp add --transport http allratestoday https://allratestoday.com/api/mcp

无需密钥即可使用。使用密钥时，发送 Authorization: Bearer art_live_…，或者如果客户端只接受 URL，则连接到 https://allratestoday.com/api/mcp?api_key=art_live_…。注册表名称：com.allratestoday/mcp。Cursor / VS Code 一键按钮：https://allratestoday.com/mcp/#hosted

📦 安装

# Run without installing (recommended)
npx -y @allratestoday/central-bank-mcp

# Or install globally
npm install -g @allratestoday/central-bank-mcp
central-bank-mcp

这两个命令都会启动 stdio MCP 服务并等待客户端连接——MCP 客户端会将它们作为子进程启动。

🏁 各客户端快速设置

Claude Code

claude mcp add central-bank-rates -- npx -y @allratestoday/central-bank-mcp
claude mcp env central-bank-rates ALLRATES_API_KEY=art_live_xxxxx

重启 Claude Code。可通过提问来验证："你能获取官方汇率的中央银行有哪些？"

Cursor

编辑 ~/.cursor/mcp.json（或项目内的 .cursor/mcp.json）：

{
  "mcpServers": {
    "central-bank-rates": {
      "command": "npx",
      "args": ["-y", "@allratestoday/central-bank-mcp"],
      "env": {
        "ALLRATES_API_KEY": "art_live_xxxxx"
      }
    }
  }
}

Claude Desktop

编辑 claude_desktop_config.json（Settings → Developer → Edit Config），添加与上述 Cursor 示例相同的 mcpServers 块，然后重启 Claude Desktop。

🧰 工具

工具	功能	方案
list_central_banks	所有收录机构及其代码、元数据和最新日期	免费（无需密钥：内置目录）
get_official_rates	某家银行发布的汇率表（或一个货币对），最新数据或指定日期的数据	无需密钥（最新数据）/ 付费（指定日期）
get_official_rate_history	一个货币对按日期排列的官方汇率序列	付费，按覆盖的月份计费，每月约 1 次调用
compare_official_rates	所有银行中一个货币对的汇率，并提供价差统计	免费（需要密钥）
get_publication_calendar	某家银行实际发布数据的日期（不含数值）	免费（需要密钥）
request_trial_key	自行申请一个有效期为 7 天、可调用 100 次的试用密钥（无需账户），并在本次会话剩余时间内使用	无需密钥，每个 IP 每天限 3 次

🔒 隐私

只有请求参数和你的 API 密钥会发送到 allratestoday.com，绝不会发送对话上下文。

📚 更多来自 AllRatesToday 的内容

• 中央银行 REST API 文档
• 各银行的 npm SDK
• @allratestoday/mcp-server — 实时中间市场汇率 MCP 服务
• 开放数据存档 — 每日镜像相同的已发布汇率表：Hugging Face · Kaggle（CC BY-NC 4.0）

🔗 链接

• API 文档
• 注册（免费）
• 控制面板
• 状态
• Postman 集合
• GitHub

许可证

MIT © AllRatesToday