AllRatesToday MCP Server（@allratestoday/mcp-server）是一个 Model Context Protocol（MCP）服务器，为 AI 助手提供外汇市场的实时数据。它让 Claude Code、Cursor、Claude Desktop、Windsurf 以及任何兼容 MCP 的客户端能够调用 AllRatesToday API，获取实时货币汇率、历史数据和多币种查询。安装后，助手可以回答诸如“当前 USD 兑 EUR 汇率是多少？”“显示过去 30 天 GBP/JPY 的走势”“按真实汇率将 250 美元转换为加元”“同时比较美元与欧元、英镑和日元”等问题。
主要能力：
- 实时中间价：覆盖 150+ 种 ISO 4217 货币，约每 60 秒刷新。
- 内置历史序列：支持 1d / 7d / 30d / 1y 时间窗口，每个周期有合理的粒度。
- 八个专用工具：get_exchange_rate、get_historical_rates、get_rates_authenticated、list_currencies、list_central_banks、get_official_rates、get_reference_rate、request_trial_key。
- 广泛兼容：使用 stdio 传输，MCP 1.x，支持 Claude Code、Cursor、Claude Desktop、Windsurf 或任何通用 MCP 宿主。
- 可无密钥运行：无需配置即可安装并基于 ECB 开放参考表回答；免费密钥可解锁 160+ 种货币的实时汇率。
- 明确数据来源：无密钥回答会说明所用汇率及发布时间；API 错误映射为清晰、可操作的消息。
- 隐私保护：仅请求参数和 API 密钥发送至 allratestoday.com，不发送对话上下文。
使用方式： 可通过 npx 零安装运行，或使用托管端点（https://allratestoday.com/api/mcp）无需安装。每个客户端有各自的配置文件（如 Claude Code 使用内置 CLI，Cursor 编辑 ~/.cursor/mcp.json，Claude Desktop 编辑对应配置文件，Windsurf 编辑 ~/.codeium/windsurf/mcp_config.json）。通用 stdio MCP 客户端使用 npx 启动命令并设置 ALLRATES_API_KEY 环境变量。也有 Claude Code 插件，捆绑两个 MCP 服务器、两个技能和五个斜杠命令（/rate、/convert、/official-rate、/fx-history、/add-currency-support）。
适用场景：
- 需要实时汇率、历史走势和多币种转换的 AI 助手交互。
- 需要官方央行或税务机关发布的固定汇率用于发票、增值税、税务申报、海关、转让定价和审计的场景。
- 需要每日固定参考汇率（Daily Reference Rate）用于报告、指数或研究序列。
限制：
- 返回的均为中间价，约每 60 秒刷新，不是税务机关或审计师可能要求的官方汇率。
- get_historical_rates 和 get_rates_authenticated 需要 ALLRATES_API_KEY；其他六个工具可无密钥使用。
- 需要 Node ≥18，目前无独立二进制。
- 免费密钥需在 allratestoday.com/register 注册、验证邮箱后获取，格式为 art_live_xxxxx。
- 免费层级适合开发和个人使用；重度使用或生产环境应考虑付费计划，具体配额见定价页面。
- 项目结构、贡献指南、错误参考等详见 GitHub 仓库。
