Exchange Rate MCP

為替レート MCP

ECB の日次参考レートに基づく、30 種類以上の通貨の最新の為替レートと金額換算に対応しています。ISO コード（USD）と中国語名（美元）のどちらも使用できます。

• 30 秒で試す：無料の公開 MCP エンドポイントがすでに稼働しています。URL を MCP クライアントに貼り付けるだけです（インストール不要、API キー不要）。
• またはセルフホスト：Python ファイル 1 つで動作します。標準ライブラリの 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 単位を換算します。	レートの日付、base→target のレート、逆レート、および（amount が指定された場合）換算額。参考レートであり、リアルタイムの取引価格ではありません。

📡 データソース、キャッシュ、制限

• 主なデータソース：Frankfurter — 欧州中央銀行（ECB）の日次参考レート。無料で、API キーは不要です。
• 自動フォールバック：主なデータソースが失敗した場合は open.er-api.com を使用します。
• 中国語の表示名（人民币、美元、欧元、日元、港币、韩元、新台币 …）と中国語の別名（美金/美刀、港元、台币、澳币 …）に対応する 32 種類の通貨。
• レートは 2 時間キャッシュされます（ECB の更新は営業日）。ホスト済みエンドポイントには、IP あたり 1 分間に 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 ごとの軽量なスライディングウィンドウ方式のレート制限ミドルウェア（デフォルトは 1 分あたり 200 リクエスト）。
• requirements.txt — mcp、uvicorn、starlette。
• server.json — MCP Registry 公式マニフェスト（公開準備済みのリモートサーバーエントリー。mcp-publisher で公開できます）。
• smithery.yaml / glama.json — ディレクトリ掲載用メタデータ。

---

🇨🇳 中国語の利用方法

ひとことで：30 種類以上の一般的な通貨の最新参考レートと金額換算に対応しています。中国語の通貨名でそのまま質問できます（「100 美元换多少人民币」）。

オンライン接続先（無料、キー不要、すぐに利用可能）：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)：為替レートを確認し、金額を換算できます。通貨は 3 文字コードまたは中国語名で指定できます（USD / 美元 / 美金 のいずれも使用可能）。target を空欄にすると、人民元／ユーロ／円／英ポンド／香港ドル／韓国ウォンの一般的なレートを返します。amount に正の数を指定すると、換算結果も返します。
• 主なデータソースは Frankfurter（欧州中央銀行 ECB の日次参考レート。無料でキー不要）です。障害時は open.er-api.com に自動で切り替わります。
• 参考レートは毎日更新されます。リアルタイムの取引価格ではありません。実際の両替では銀行窓口のレートを確認してください。

サービスの特長：データソースはすべて公開 API のため、登録や支払いは不要です。サーバー側でメモリキャッシュを使用し、障害時には自動で代替データソースに切り替わります。IP あたり 1 分間に 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 キーやアカウントは一切不要です。

📄 ライセンス

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：検索で見つけて、ローカルにインストールするためのリンクを取得
• ✅ サーバーの稼働状況を毎週確認し、稼働中のサーバーを上位に表示
• 🆓 無料で利用可能。キーは不要です

📖 3 ステップのセットアップガイド／中国語の接続ガイド：https://mcp.pianam.cn/ai-gateway