Exchange Rate MCP

cn.pianam.mcpPublished by mcp.pianam.cnOfficial publisherv1.0.0Updated Oct 24, 2026

MCP server for live currency exchange rates and conversion, ISO codes and Chinese currency names.

The publisher's own server: China 12306 Train Tickets MCP

VerifiedStreamable HTTPWeb executableFinance

Overview

AI-generated overview

A remote MCP server that lets an assistant look up live currency exchange rates and convert amounts across 30+ currencies, using ISO codes or Chinese currency.

What you can do
Query exchange rates between a base and target currency, given as ISO codes or Chinese names, with an empty target returning common rates such as CNY, EUR, JPY, GBP, HKD and KRW. Convert an amount of the base currency and get the converted value alongside the rate date, forward rate and reverse rate.
When to use it
Useful when a conversation needs a quick reference exchange rate or a rough currency conversion, including questions phrased with Chinese currency names. Rates are ECB daily reference figures, so it suits informational answers rather than trading or settlement.
Requirements
A remote Streamable HTTP endpoint; no install, account or API key is needed. Self-hosting is optional and needs Python with the mcp, uvicorn and starlette packages, or Docker, plus outbound access to the public rate sources.
Before you install
Rates are daily ECB reference rates, not live trading prices, and the README says actual exchange should follow the bank counter. The hosted endpoint is rate-limited per IP, and the README also advertises a separate aggregation gateway that is not part of this server.

Installation

In SourceWeft

  1. Open Exchange Rate MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/cn.pianam.mcp%2Fexchange-rate-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Exchange Rate MCP

[License: MIT] [MCP] [Remote]

Live currency exchange rates and amount conversion for 30+ currencies, accepting both ISO codes (USD) and Chinese names (美元), based on ECB daily reference rates.

  • Try it in 30 seconds: a free public MCP endpoint is already running — just paste the URL into your MCP client (no install, no API key).
  • Or self-host: a single Python file, stdlib HTTP + FastMCP, zero paid dependencies.

⚡ Use the hosted endpoint (no setup)

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

Transport: Streamable HTTP (MCP 2025-03-26 compatible). No authentication required.

🔌 Client configuration

Add this to your MCP client's mcpServers configuration (Claude Desktop claude_desktop_config.json, Cursor mcp.json, Cline, Cherry Studio, etc.):

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

Clients that do not accept "type": "http" (some Cherry Studio / older Cline versions) accept the same entry with just "url".

🧰 Tools

ToolParametersReturns
query_exchange_rate(base="USD", target="", amount=0)base / target: ISO code or Chinese name — "USD" / "美元" / "美金" all work. Empty target returns common rates (CNY/EUR/JPY/GBP/HKD/KRW).
amount: optional, converts N units of base currency.		Rate date, base→target rate, reverse rate, and (when amount is given) the converted amount. Reference rates — not live trading prices.

📡 Data sources, caching & limits

  • Primary source: Frankfurter — European Central Bank (ECB) daily reference rates, free, no API key.
  • Automatic fallback: open.er-api.com if the primary source fails.
  • 32 currencies with Chinese display names (人民币, 美元, 欧元, 日元, 港币, 韩元, 新台币 …) and Chinese aliases (美金/美刀, 港元, 台币, 澳币 …).
  • Rates cached for 2 hours (ECB updates on working days); hosted endpoint rate-limited to 200 requests / minute / IP.

🐢 Self-hosting

bash
git clone https://github.com/boy-373/exchange-rate-mcp.gitcd exchange-rate-mcppip install -r requirements.txtpython 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"

Then point your MCP client at http://127.0.0.1:8005/mcp. No API keys or accounts are ever required.

🐳 Self-host with Docker

Option A — pull the pre-built image (fastest, no build):

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

Option B — build from source:

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

Then point your MCP client at http://127.0.0.1:8000/mcp. The container listens on 0.0.0.0:8000 by default (override with -e MCP_PORT=9000 and adjust -p accordingly). No API keys or accounts required.

🗂️ Files

  • exchange_mcp_server.py — the MCP server (FastMCP, Streamable HTTP transport).
  • rate_limit.py — lightweight per-IP sliding-window rate-limit middleware (200 req/min default).
  • requirements.txt — mcp, uvicorn, starlette.
  • server.json — official MCP Registry manifest (remote server entry, ready to publish with mcp-publisher).
  • smithery.yaml / glama.json — directory listing metadata.

🇨🇳 中文使用说明

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

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

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

json
{  "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 次/分钟。

本地部署：

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

Docker 自托管：

bash
# 方式一：直接拉预构建镜像（最快，无需构建）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-mcpdocker 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 或账号。

📄 License

MIT © 2026 boy-373

Install via Smithery

One-click install for Smithery-supported clients (Claude Desktop, Cursor, etc.):

[Smithery]

Or run:

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

🔌 Use with Any AI Client — One-Click MCP Gateway

We host a free MCP aggregation gateway: your AI assistant (Cherry Studio, Claude Desktop, Cursor, Cline — any MCP client) discovers and uses MCP tools through a single URL:

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

Add it once, then talk in plain language — the AI automatically searches → inspects → calls the right MCP for you.

  • 🔍 Search across 22,000+ indexed MCP servers (Chinese & English)
  • ⚡ 50+ live hosted MCPs callable directly out of the box (weather, exchange rates, hot trends, IP geo, train tickets…)
  • 📦 GitHub-based MCPs: search finds them with links to install locally
  • ✅ Servers health-checked weekly — alive ones ranked first
  • 🆓 Free to use, no key required

📖 3-step setup guide / 中文接入教程: https://mcp.pianam.cn/ai-gateway

Source: README.md at commit eb6f007

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Pianam integrations

China 12306 Train Tickets MCP

cn.pianam.mcpOfficial publisher

A read-only MCP server that lets an assistant look up China Railway 12306 train schedules and remaining seat availability by Chinese station name and date.

Streamable HTTPWeb executable
Location & LifestyleNot indexed yetOct 24, 2026

Weather Forecast MCP

cn.pianam.mcpOfficial publisher

Remote MCP server that lets an assistant look up current weather and up to 7-day forecasts for cities worldwide, with Chinese city names and Chinese output.

Streamable HTTPWeb executable
Location & LifestyleNot indexed yetNov 2, 2026

Stock Mcp

cn.pianam.mcpOfficial publisher

A remote MCP server that gives an assistant real-time China A-share stock quotes and the three major market indices, with dual-source fallback.

Streamable HTTPWeb executable
FinanceNot indexed yetOct 24, 2026

MCP Aggregation Gateway — 22k+ MCP search & call

cn.pianam.mcpOfficial publisher

A remote MCP gateway that lets an assistant search a catalog of 22k+ MCP servers and call 50+ hosted tools without an API key.

Streamable HTTPWeb executable
Developer ToolsNot indexed yetOct 24, 2026

IP Location MCP

cn.pianam.mcpOfficial publisher

A remote MCP server that looks up IPv4 geolocation — country, region, city, coordinates, timezone, ISP and ASN — with Chinese-language output.

Streamable HTTPWeb executable
Location & LifestyleNot indexed yetOct 24, 2026