Exchange Rate MCP

Exchange Rate MCP

基于欧洲央行每日参考汇率，提供 30 多种货币的实时汇率和金额换算，支持 ISO 代码（USD）和中文名称（美元）。

• 30 秒即可试用：免费的公共 MCP 端点已在运行，只需将 URL 粘贴到 MCP 客户端中（无需安装、无需 API 密钥）。
• 也可自托管：单个 Python 文件，使用标准库 HTTP + FastMCP，无需付费依赖。

⚡ 使用托管端点（无需设置）

https://mcp.pianam.cn/exchange-mcp/mcp

传输方式：Streamable HTTP（兼容 MCP 2025-03-26）。无需身份验证。

🔌 客户端配置

将以下内容添加到 MCP 客户端的 mcpServers 配置中（Claude Desktop 的 claude_desktop_config.json、Cursor 的 mcp.json、Cline、Cherry Studio 等）：

{
  "mcpServers": {
    "exchange-rate": {
      "type": "http",
      "url": "https://mcp.pianam.cn/exchange-mcp/mcp"
    }
  }
}

不接受 "type": "http" 的客户端（部分 Cherry Studio / 较旧版本的 Cline）可使用仅包含 "url" 的相同条目。

🧰 工具

工具	参数	返回内容
query_exchange_rate(base="USD", target="", amount=0)	base / target：ISO 代码或中文名称——"USD" / "美元" / "美金" 均可使用。target 为空时返回常用汇率（CNY/EUR/JPY/GBP/HKD/KRW）。 amount：可选，用于换算 N 个单位的基础货币。	汇率日期、基础货币→目标货币汇率、反向汇率，以及（提供 amount 时）换算后的金额。此为参考汇率，并非实时交易价格。

📡 数据源、缓存与限制

• 主要数据源：Frankfurter——欧洲央行（ECB）每日参考汇率，免费且无需 API 密钥。
• 自动备用数据源：open.er-api.com，主数据源不可用时启用。
• 支持 32 种货币，提供中文显示名称（人民币、美元、欧元、日元、港币、韩元、新台币……）和中文别名（美金/美刀、港元、台币、澳币……）。
• 汇率缓存 2 小时（ECB 在工作日更新）；托管端点限制为每个 IP 每分钟 200 次请求。

🐢 自托管

git clone https://github.com/boy-373/exchange-rate-mcp.git
cd exchange-rate-mcp
pip install -r requirements.txt
python exchange_mcp_server.py
# the server listens on 127.0.0.1:8005 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python exchange_mcp_server.py
#   MCP_ALLOWED_HOSTS="your-domain.com,127.0.0.1:*"
#   MCP_ALLOWED_ORIGINS="https://your-domain.com"

然后将 MCP 客户端指向 http://127.0.0.1:8005/mcp。 始终无需 API 密钥或账号。

🐳 使用 Docker 自托管

选项 A — 拉取预构建镜像（最快，无需构建）：

docker run -d -p 8000:8000 --name exchange-rate-mcp ghcr.io/boy-373/exchange-rate-mcp:latest

选项 B — 从源代码构建：

git clone https://github.com/boy-373/exchange-rate-mcp.git
cd exchange-rate-mcp
docker build -t exchange-rate-mcp .
docker run -d -p 8000:8000 --name exchange-rate-mcp exchange-rate-mcp

然后将 MCP 客户端指向 http://127.0.0.1:8000/mcp。 容器默认监听 0.0.0.0:8000（可通过 -e MCP_PORT=9000 覆盖，并相应调整 -p）。无需 API 密钥或账号。

🗂️ 文件

• exchange_mcp_server.py — MCP 服务（FastMCP，Streamable HTTP 传输）。
• rate_limit.py — 轻量级的按 IP 滑动窗口限流中间件（默认每分钟 200 次请求）。
• requirements.txt — mcp、uvicorn、starlette。
• server.json — 官方 MCP Registry 清单（远程服务条目，可使用 mcp-publisher 发布）。
• smithery.yaml / glama.json — 目录列表元数据。

---

🇨🇳 中文使用说明

一句话：30 多种常用货币的实时参考汇率与金额换算，直接使用中文货币名称提问（「100 美元换多少人民币」）。

在线直连地址（免费、无需 Key、开箱即用）：https://mcp.pianam.cn/exchange-mcp/mcp

在 MCP 客户端（Claude Desktop / Cursor / Cherry Studio / Cline 等）的配置中加入：

{
  "mcpServers": {
    "exchange-rate": {
      "type": "http",
      "url": "https://mcp.pianam.cn/exchange-mcp/mcp"
    }
  }
}

工具：

• query_exchange_rate(base, target, amount)：查询汇率并可换算金额。货币可使用三字母代码或中文名称（USD / 美元 / 美金均可）；target 留空时返回人民币/欧元/日元/英镑/港币/韩元的常用汇率；amount 提供正数时会同时返回换算结果。
• 主数据源为 Frankfurter（欧洲央行 ECB 每日参考汇率，免费且无需 Key），故障时自动切换至 open.er-api.com。
• 参考汇率每日更新，并非实时交易牌价；实际换汇请以银行柜台为准。

服务特性：所有数据源均为公开接口，无需注册或付费；服务端内存缓存，失败时自动降级/切换到备用通道；每个 IP 限流每分钟 200 次。

本地部署：

git clone https://github.com/boy-373/exchange-rate-mcp.git
cd exchange-rate-mcp
pip install -r requirements.txt
python exchange_mcp_server.py
# 默认监听 127.0.0.1:8005，可用环境变量 MCP_HOST / MCP_PORT / MCP_ALLOWED_HOSTS / MCP_ALLOWED_ORIGINS 覆盖

Docker 自托管：

# 方式一：直接拉预构建镜像（最快，无需构建）
docker run -d -p 8000:8000 --name exchange-rate-mcp ghcr.io/boy-373/exchange-rate-mcp:latest

# 方式二：从源码构建
git clone https://github.com/boy-373/exchange-rate-mcp.git && cd exchange-rate-mcp
docker build -t exchange-rate-mcp .
docker run -d -p 8000:8000 --name exchange-rate-mcp exchange-rate-mcp
# MCP 地址填：http://127.0.0.1:8000/mcp

容器默认监听 0.0.0.0:8000（可使用 -e MCP_PORT=端口 修改），无需任何 API Key 或账号。

📄 许可证

MIT © 2026 boy-373

通过 Smithery 安装

一键安装到 Smithery 支持的客户端（Claude Desktop、Cursor 等）：

或运行：

npx -y @smithery/cli install 1561852680/exchange-rate-mcp --client claude

---

🔌 与任意 AI 客户端搭配使用 — 一键 MCP 网关

我们托管了一个免费的 MCP 聚合网关：你的 AI 助手（Cherry Studio、Claude Desktop、Cursor、Cline——任意 MCP 客户端）都可以通过一个 URL 发现并使用 MCP 工具：

https://mcp.pianam.cn/ai/mcp

添加一次，然后用自然语言交谈——AI 会自动为你搜索 → 检查 → 调用合适的 MCP。

• 🔍 搜索 22,000+ 个已编入索引的 MCP 服务（中文和英文）
• ⚡ 50+ 个实时托管的 MCP 可开箱即用（天气、汇率、热点趋势、IP 地理位置、火车票……）
• 📦 基于 GitHub 的 MCP：搜索结果会提供在本地安装的链接
• ✅ 每周检查服务健康状况——正常运行的服务优先显示
• 🆓 免费使用，无需密钥

📖 三步设置指南 / 中文接入教程：https://mcp.pianam.cn/ai-gateway