Realtime Exchange Rate Mcp

リアルタイム為替レート MCP サーバー — @allratestoday/mcp-server

Claude Code、Cursor、Claude Desktop、Windsurf、その他すべての MCP 対応クライアントが、AllRatesToday API からリアルタイム為替レート、過去の推移、複数通貨のレートを取得できる Model Context Protocol サーバーです。レートはリテールのスプレッドを含まないミッドマーケットレートです。

英語 | 簡体字中国語

インストール後、アシスタントは次のような質問に回答できます。

• 「現在の USD から EUR へのレートはいくらですか？」
• 「過去 30 日間の GBP/JPY の動きを見せてください。」
• 「実際のレートで 250 USD を CAD に換算してください。」
• 「USD と EUR、GBP、JPY を同時に比較してください。」
• 「対応しているすべての通貨を一覧表示してください。」
• 「本日の USD の ECB 公式レートはいくらですか？」

この README では npm パッケージ @allratestoday/mcp-server（現行バージョン 0.7.6）について説明します。ソースは AllRates-Today/mcp-server にあります。

🚀 機能

• 💱 リアルタイムのミッドマーケットレート — 対応する ISO 4217 通貨ペアの最新レート
• 📈 過去の推移を内蔵 — 1d（1時間ごと）、7d（1日ごと）、30d（1日ごと）、1y（1週間ごと）
• 🧰 目的に特化した 8 つのツール — get_exchange_rate、get_historical_rates、get_rates_authenticated、list_currencies、list_central_banks、get_official_rates、get_reference_rate、request_trial_key。モデルが正しく使えるよう、機能を絞っています（ホスト型エンドポイント https://allratestoday.com/api/mcp には 11 個のツールがあり、これらに加えて get_official_rate_history、compare_official_rates、get_publication_calendar が含まれます）
• 🏛️ 公式レート — 121 の中央銀行と 3 つの税務当局による最新のレート表を、キーなしで利用できます
• 🔌 MCP が使える場所ならどこでも動作 — stdio トランスポート、MCP SDK 1.x に対応。Claude Code、Cursor、Claude Desktop、Windsurf、または汎用の stdio ホストで利用できます
• 🔓 API キーなしで利用可能 — キーなしのモードで起動し、キーがないことを理由に終了することはありません。キーなしで取得した回答には、参照元の公式レート表とその rate_date が示されます
• 🛡️ 正直なエラー処理 — 推測で回答せず、上流 API のエラーをそのまま返します。また、キーが必要なツールでは、取得方法を案内します
• 🔒 情報が漏れることはありません — allratestoday.com に送信されるのはリクエストのパラメーターと API キーだけで、会話のコンテキストは送信されません
• 📦 実行時依存関係は 2 つ — @modelcontextprotocol/sdk と zod。Node.js ≥ 18

キーを使用すると、get_exchange_rate、get_historical_rates、get_rates_authenticated はミッドマーケットレートを返します。これは価格表示や換算に適したレートです。税務当局や監査人が求める公式レートではありません。公式レートが必要な場合は、get_official_rates（121 の中央銀行と 3 つの税務当局の最新公開レート表をキーなしで利用可能）を使うか、AllRatesToday のドキュメントをご覧ください。

🔑 API キーを取得する

キーは任意です。ALLRATES_API_KEY がなくても、サーバーはキーなしモードで起動します。

ツール	キーなし	利用できる内容
get_exchange_rate	✅	公式中央銀行レート：まず ECB の表を確認し、該当しない場合は対象通貨または基準通貨を発行する中央銀行のレートを使用します（例：USD/GBP → Bank of England）。キーなしで利用できるのは、いずれかの銀行が公表する通貨ペア、またはその逆ペア（derived: true としてフラグ付けされたもの）のみです
list_currencies	✅	サポート対象のコード全 160 種類以上
list_central_banks	✅	コードと最新の公表日を含む、全 121 の中央銀行と 3 つの税務当局
get_official_rates	✅	最新の公式レート表（または 1 つの通貨ペア）。日付指定の表には有料プランのキーが必要です
get_reference_rate	✅	最新の Daily Reference Rate 表（ロンドン時間 16:00）。過去の日付には有料プランのキーが必要です
request_trial_key	✅	アカウントなしで 100 回呼び出し可能な 7 日間有効のキーを発行し、セッションで使用します
get_historical_rates	🔑	有料プランのキーが必要です（無料キーとトライアルキーでは 403 が返されます）
get_rates_authenticated	🔑	最新レートには無料キーを使用できます。time（過去の日時）の指定には有料プランが必要です

無料キーを使うと、160 種類以上の通貨のリアルタイムの仲値と、複数の対象通貨を指定した検索を利用できます。過去のレートと日付指定のレート（仲値の履歴、指定時点の検索、日付指定の公式レート表と参照レート表）には、有料プランが必要です。無料キーとトライアルキーでは 403 historical_requires_paid_plan が返されます（料金）。

1. allratestoday.com/register で登録します
2. メールアドレスを確認します
3. ダッシュボードからキーをコピーします（形式：art_live_xxxxx）
4. 以下の設定で ALLRATES_API_KEY として使用します

キーがない場合、サーバーは標準エラー出力にキーなしモードの簡単な概要を表示して、実行を続けます。キーがないことを理由に終了することはありません。

📦 インストール

最も簡単なのは、以下のすべての設定で使用している**npx によるインストール不要の方法**です。

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

# Or install globally
npm install -g @allratestoday/mcp-server
allratestoday-mcp

どちらのコマンドも stdio MCP サーバーを起動し、クライアントの接続を待ちます。シェルから対話的に実行するものではありません。MCP クライアントがサブプロセスとして起動します。

🏁 クイックスタート

クライアントごとに、MCP サーバーの設定を読み込むファイルが異なります。以下から使用するものを選んでください。

Claude Code

最も手早い方法は、組み込みの CLI を使うことです。

claude mcp add allratestoday -- npx -y @allratestoday/mcp-server
claude mcp env allratestoday ALLRATES_API_KEY=art_live_xxxxx

Claude Code を再起動してから、*「現在の USD から EUR へのレートは？」*と尋ねます。

Cursor

~/.cursor/mcp.json を編集します（プロジェクト単位のサーバーを設定する場合は、プロジェクト内の .cursor/mcp.json を編集します）。

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

Cursor を再起動します。8 つのツールが MCP ツールピッカーに表示されます。

Claude Desktop

設定ファイルを編集します（パスは OS によって異なります）。

OS	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

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

Claude Desktop を完全に終了してから再度開いてください（macOS では Cmd+Q、Windows ではシステムトレイのアイコンを右クリックして「終了」）。ウィンドウを閉じるだけでは、古い設定が読み込まれたままになります。

Windsurf

~/.codeium/windsurf/mcp_config.json を編集し、上記と同じ mcpServers ブロックを追加してから、Windsurf を再起動します。

汎用 stdio MCP クライアント

stdio トランスポートに対応する MCP ホストであれば、どれでも使用できます。起動コマンドは次のとおりです。

npx -y @allratestoday/mcp-server

必要に応じて、サブプロセスの環境変数に ALLRATES_API_KEY を設定します。同じ設定ブロックは、このリポジトリ内の .mcp.json からもコピーできます。Smithery 向けの同じ stdio 起動方法は smithery.yaml に、MCP レジストリのマニフェストは server.json に記載されています。

動作を確認する

1. サーバーが起動する — クライアントを開きます。キーの有無にかかわらず起動するため、赤い点や「接続に失敗しました」と表示される場合は、クライアントがサーバーを起動できていません。通常は npx または Node ≥ 18 が原因です（トラブルシューティングを参照）。
2. ツールが一覧表示される — ほとんどのクライアントには、8 つのツールすべてが表示される「tools」または「MCP」パネルがあります。
3. 実際の呼び出しで数値が返る — 「現在の USD から EUR への為替レートは？」 と尋ねます。アシスタントは get_exchange_rate(source: "USD", target: "EUR") を呼び出し、実際のレートを返します。ツールを呼び出さずに数値を返す場合、サーバーは接続されていません。

📚 API リファレンス

ツール	用途	必須の入力
get_exchange_rate	1 組の通貨の現在のレート	source、target
get_historical_rates	事前設定された期間の時系列データ	source、target
get_rates_authenticated	1 回の呼び出しで複数の通貨を指定。特定時点の指定も可能	source、target
list_currencies	対応するすべてのコード、名称、記号	—
list_central_banks	対象となる中央銀行／税務当局とそのコード	—
get_official_rates	指定した機関が公開した公式レート表（または 1 組の通貨のレート）	bank
get_reference_rate	日次参照レート。営業日ごとに固定されたミッドマーケットのレート表（ロンドン時間 16:00）	—
request_trial_key	アカウント不要で、100 回・7 日間有効のトライアルキーを発行	—

get_historical_rates と get_rates_authenticated のみ ALLRATES_API_KEY が必要です。無料キーでは最新の複数通貨レートを取得できますが、get_historical_rates と time には有料プランが必要です。入力スキーマでは additionalProperties: false が設定されているため、不明なフィールドは拒否されます。各ツールの詳細なリファレンスは、mcp-server READMEを参照してください。

get_exchange_rate

2 種類の通貨間の現在のミッドマーケットレートです。キーがある場合は GET /rate を呼び出します。キーがない場合は GET /open/central-bank/{bank} を呼び出します（最初に ECB、次に対象通貨を発行する銀行、最後に基準通貨を発行する銀行）。

フィールド	型	必須	説明
source	string（正確に 3 文字）	はい	ISO 4217 コード（例：USD）
target	string（正確に 3 文字）	はい	ISO 4217 コード（例：EUR）

{ "source": "USD", "target": "EUR" }

キーを使用した場合のレスポンス：

{ "rate": 0.888889, "source": "mid-market" }

キーを使用しない場合のレスポンス（USD → GBP は ECB のレート表にないため、Bank of England が応答します。逆方向のレートを公開しているため、derived: true となります）：

{
  "rate": 0.7598784195,
  "source": "Bank of England official rate (keyless mode)",
  "bank": "boe",
  "rate_date": "2026-10-14",
  "derived": true,
  "note": "Keyless mode: this is the Bank of England official rate published on 2026-10-14, not a live mid-market quote. For real-time rates across 160+ currencies set ALLRATES_API_KEY — free tier at https://allratestoday.com/register."
}

get_historical_rates

固定期間における通貨ペアの時系列データです。GET /historical-rates を呼び出します。有料プランの API キーが必要です（無料キーとトライアルキーでは 403 が返されます）。

フィールド	型	必須	説明
source	string（正確に 3 文字）	はい	基準通貨コード
target	string（正確に 3 文字）	はい	対象通貨コード
period	string	いいえ（デフォルトは 7d）	1d、7d、30d、1y のいずれか

期間ごとのデータ間隔：

period	データ間隔
1d	1 時間ごと
7d	1 日ごと
30d	1 日ごと
1y	1 週間ごと

{ "source": "USD", "target": "INR", "period": "30d" }

レスポンス（省略）：

{
  "source": "USD",
  "target": "INR",
  "period": "30d",
  "data": [
    { "date": "2026-09-17", "rate": 96.1006, "timestamp": 1789603200000 },
    { "date": "2026-09-18", "rate": 95.8142, "timestamp": 1789689600000 },
    "...",
    { "date": "2026-10-16", "rate": 94.9643, "timestamp": 1792108800000 }
  ]
}

get_rates_authenticated

1 回の呼び出しで複数の対象通貨を指定でき、任意で過去の時刻または集計期間を指定できます。GET /v1/rates を呼び出します。

フィールド	型	必須	説明
source	string（正確に 3 文字）	はい	基準通貨コード
target	string	はい	1 つ以上のコード。カンマ区切り（EUR,GBP,JPY）
time	string（ISO 8601 日時）	いいえ	過去の特定時点（有料プラン）
group	string	いいえ	hour、day、week、month のいずれか

{ "source": "USD", "target": "EUR,GBP,JPY" }

レスポンス — { rates: [{ rate, source, target, time }] }：

{
  "rates": [
    { "rate": 0.888889, "source": "USD", "target": "EUR", "time": "2026-10-16T12:16:01+0000" },
    { "rate": 0.749766, "source": "USD", "target": "GBP", "time": "2026-10-16T12:16:01+0000" },
    { "rate": 157.985, "source": "USD", "target": "JPY", "time": "2026-10-16T12:16:01+0000" }
  ]
}

list_currencies

コード、名称、記号を含む、対応するすべての通貨です。GET /v1/symbols を呼び出します。上流で 24 時間キャッシュされるため、他のツールを使う前にユーザー入力を検証する用途に適しています。

入力 — なし。

レスポンス（省略）：

{
  "currencies": [
    { "code": "USD", "name": "US Dollar", "symbol": "$" },
    { "code": "EUR", "name": "Euro", "symbol": "€" },
    { "code": "GBP", "name": "British Pound", "symbol": "£" },
    "..."
  ],
  "count": 163
}

list_central_banks

公式ソースすべて（121 の中央銀行に加え、HMRC、米国財務省、スイスのBAZG）と、get_official_rates が bank として受け取る code を一覧表示します。キーは不要です。GET /open/central-banks を呼び出します（キーがある場合は /v1/central-banks）。

{
  "sources": [
    { "code": "ecb", "name": "European Central Bank", "latest": "2026-10-15", "age_days": 1, "stale": false, "cadence": "daily" },
    { "code": "fed", "name": "US Federal Reserve (H.10)", "latest": "2026-10-09", "age_days": 7, "stale": false, "cadence": "weekly" },
    "..."
  ],
  "stale_count": 3,
  "checked_at": "2026-10-16T12:16:46.232Z"
}

get_official_rates

機関が公表した、固定され引用可能なレートです。入力：bank（必須）、任意の date（YYYY-MM-DD、有料プラン — 無料キーでは 403 Historical central bank rates require a paid plan が返されます）、1 組の通貨ペアを指定する任意の source と target。最新の表はキーなしで取得できます。

{
  "bank": "ecb",
  "rate_date": "2026-10-15",
  "source": "EUR",
  "target": "USD",
  "rate": 1.1208,
  "rate_type": "reference",
  "derived": false,
  "method": "published",
  "age_days": 1,
  "stale": false,
  "cadence": "daily",
  "attribution": { "source": "Official rates published by ECB, served by AllRatesToday", "url": "https://allratestoday.com/central-bank-rates-api/ecb/", "terms": "Free to use with visible attribution linking to allratestoday.com" }
}

🗺️ 対応通貨

AllRatesToday API が提供するすべての通貨を、これらのツールから利用できます。正確な最新リストは list_currencies を呼び出して確認してください。よく使われるコードには、次のものがあります。

🇺🇸 USD · 🇪🇺 EUR · 🇬🇧 GBP · 🇯🇵 JPY · 🇨🇦 CAD · 🇮🇳 INR

get_exchange_rate と get_historical_rates の source および target フィールドは、3 文字ちょうどの値として検証されます。そのため、通貨名ではなく ISO 4217 コードを渡してください。

⚙️ 環境変数

変数	デフォルト	必須	用途
ALLRATES_API_KEY	—	いいえ	Authorization ヘッダーで Bearer トークンとして送信する API キーです。未設定の場合はキーなしモードになり、キーがないことを理由にサーバーが終了することはありません。
ALLRATES_BASE_URL	https://allratestoday.com/api	いいえ	セルフホスト環境またはステージング環境で使う場合の URL 上書き値です。末尾のスラッシュは削除されます。

これらはシェルではなく、MCP クライアントの設定（env ブロック内）で指定してください。MCP サーバーは、分離された環境でサブプロセスとして起動されます。

🛡️ エラー処理

ツールの失敗は、isError: true を含む MCP ツールの結果として返されます。テキストは AllRatesToday error (<status>): <message> です。

HTTP ステータス	メッセージ
400	API の error フィールド。存在しない場合は Bad request — possibly an unknown currency code
401	Invalid AllRatesToday API key
403	HTTP 403 — <upstream message>。例：無料キーまたはトライアルキーで get_historical_rates または time を使った場合は Historical rates require a paid plan…、日付を指定した表の場合は Historical central bank rates require a paid plan…
404（キーなし）	No keyless official source covers X/Y. Real-time rates for 160+ currencies need an API key …
429	AllRatesToday API quota exceeded
5xx	HTTP <status> — <upstream message>

HTTP 呼び出しの前にローカルで発生するエラー：

• キーなしで get_rates_authenticated を呼び出す（time なし） → … needs an AllRatesToday API key. The free tier covers it — sign up at https://allratestoday.com/register …
• キーなしで get_historical_rates を呼び出す、または time を指定して get_rates_authenticated を呼び出す → … needs an AllRatesToday API key on a paid plan …
• キーなしで date を指定して get_official_rates / get_reference_rate を呼び出す → … needs an AllRatesToday API key on a paid plan …
• 認識できないツール名 → MCP error -32602: Tool <name> not found

これらはテキストとして返されるため、アシスタントがユーザーに伝えます。429 は 「API のクォータを超過しました」 と表示されます。

🛠️ トラブルシューティング

症状	考えられる原因	対処方法
クライアントに「MCP server failed to start」と表示される、または赤い点が表示される	キーがないことが原因ではありません（0.5.0 以降はキーなしで起動します）。通常は、npx がレジストリに接続できないか、Node のバージョンが 18 より古いことが原因です	シェルで npx -y @allratestoday/mcp-server を実行し、標準エラー出力を確認してください
すべての呼び出しで 401 エラーが返される	キーの形式が正しくない、一部が欠落している、または無効化されている	ダッシュボードから新しいキーをコピーしてください
呼び出しで 429 エラーが返される	クォータを使い切っています。無料プランではリセットされません	allratestoday.com/pricing でアップグレードしてください
呼び出しで 403 エラーが返される	無料キーまたはトライアルキーでの get_historical_rates、あるいは get_official_rates / get_reference_rate に対する time または date の指定	履歴データは有料プラン限定です。最新のレートを取得するには date / time を省略するか、アップグレードしてください
get_historical_rates で 400 エラーが返される	期間が無効、または通貨コードが不明	period は 1d / 7d / 30d / 1y のいずれかである必要があります。コードは正確に 3 文字で指定してください
サーバーは起動するが、ツールが表示されない	設定変更後にクライアントを再読み込みしていない	クライアントを完全に終了し（閉じるだけではなく）、再度開いてください
npx は実行されるが、いつまでも停止したままになる	正常です。サーバーは stdio で MCP クライアントが接続するのを待っています	MCP クライアントから起動してください

サーバーの動作を確認するには、手動で実行します（キーの有無は問いません）。

ALLRATES_API_KEY=art_live_xxxxx npx -y @allratestoday/mcp-server

出力がなければ正常です。標準出力は MCP プロトコル専用で、エラーは標準エラー出力に出力されます。

💡 注意事項

会話やクエリのデータは保存されますか？ いいえ。allratestoday.com に送信されるのは API キーとリクエストパラメーター（source、target、period、time、group）のみです。モデルの会話コンテキストは送信されません。

API キーはどのように扱われますか？ AllRatesToday API へのリクエストの Authorization ヘッダーに、Bearer トークンとしてのみ送信されます。サーバーがキーを記録することはありません。

最初の呼び出しが遅いのはなぜですか？ npx のコールドスタート（初回実行時にパッケージをダウンロードします）に加え、上流キャッシュのミスが発生するためです。

npm / Node なしで実行できますか？ 現時点ではできません。engines で Node ≥ 18 が必要です。スタンドアロンバイナリが必要な場合は、issue を作成してください。

セルフホストのオプションはありますか？ ALLRATES_BASE_URL を独自のインスタンスに指定してください。

ほかのクライアントでも動作しますか？ stdio トランスポートに対応する MCP ホストならどれでも動作します。また、リモート MCP クライアントではホストされたエンドポイント https://allratestoday.com/api/mcp を使用できます。上記の 4 つのクライアントは、このページに設定方法が記載されているものです。

👩‍💻 開発

このリポジトリの src/ は、古い 0.3.x のスナップショットです。公開済みパッケージは AllRates-Today/mcp-server からビルドされています。開発はこちらで行ってください。

git clone https://github.com/AllRates-Today/mcp-server.git
cd mcp-server
npm install
npm run build
ALLRATES_API_KEY=art_live_xxxxx node dist/index.js

npm run build は tsc を実行し、npm run dev はファイルを監視して再ビルドし、npm start はコンパイル済みのサーバーを実行します。CI（.github/workflows/ci.yml）では、main へのすべてのプッシュとすべてのプルリクエストに対して、Node 22 で npm ci && npm run build を実行します。

ローカルの AllRatesToday インスタンスに対してテストするには、次のようにします。

ALLRATES_BASE_URL=http://localhost:8080/api ALLRATES_API_KEY=test_key node dist/index.js

プロジェクト構成：

src/
├── index.ts      # MCP server, tool definitions, request handlers
├── client.ts     # HTTP client for the AllRatesToday API + error mapping
└── home-banks.ts # currency → issuing central bank (keyless fallback; mcp-server only)
dist/             # Compiled JS (gitignored)
server.json       # MCP registry manifest
smithery.yaml     # Smithery launch config
.mcp.json         # Ready-to-copy client config

Issue や PR は歓迎します。PR を作成する前に、npm run build が成功すること、実際の API キーを使って変更をテストすること、ツールの動作を変更した場合は src/index.ts のツール説明と上記の API リファレンスの両方を更新することを確認してください。

📝 変更履歴

変更履歴の全文：mcp-server README → 変更履歴。最近の主な変更：

• 0.7.6 — time を指定したキー不要の get_rates_authenticated で、有料プランが必要であることを通知するようになりました。履歴データは有料プラン限定であることを明記しました
• 0.7.4 — キー不要の get_exchange_rate が、ECB のレート表から、いずれかの通貨を発行する中央銀行のレートにフォールバックするようになりました（USD/GBP、GBP/JPY、USD/INR のレートをキーなしで取得できます）。ホスト型エンドポイントと同様の動作です。日付指定のレート表でエラーが発生した場合、有料プランが必要であることを通知します
• 0.7.0 — get_reference_rate（日次参照レート）と request_trial_key（自分で発行できる100回分のトライアルキー）
• 0.6.0 — キー不要の list_central_banks と get_official_rates（121の中央銀行と3つの税務当局）
• 0.5.0 — キー不要モード：API キーなしでも終了せずにサーバーが起動し、応答するようになりました
• 0.3.x — すべてのツールで API キーが必要でした。起動時に明確な手順を表示して即時終了していました
• 0.2.x — ニュースツールを削除し、get_historical_rates に認証を必須としました
• 0.1.x — 5つのツールを含む初回リリース

🔗 リンク

• ウェブサイト： allratestoday.com
• API ドキュメント： allratestoday.com/docs
• 無料の API キー： allratestoday.com/register
• ステータス： allratestoday.com/status
• Postman： allratestoday.com/postman
• サポート： allratestoday.com/contact
• npm： @allratestoday/mcp-server
• MCP プロトコル： modelcontextprotocol.io
• バグ報告： github.com/AllRates-Today/mcp-server/issues
• AI エージェント： Claude Code プラグイン /plugin marketplace add AllRates-Today/claude-code-plugin · ホスト型 MCP エンドポイント https://allratestoday.com/api/mcp（キー不要）
• 2026年10月の新機能： エージェントがトライアルキーを自分で発行できるようになりました — POST https://allratestoday.com/api/agent/keys（JSON）→ 100回の呼び出し／7日間 — また、キー不要の日次参照レート（ロンドン時間16:00のフィックス）を https://allratestoday.com/api/open/reference-rate で取得できます
• ダッシュボード： allratestoday.com/profile

📜 ライセンス

MIT — LICENSE をご覧ください。