currency

mcp-currency

別の通貨でいくらになるかをアシスタントに尋ねると、日付付きの実際の換算結果が得られます。欧州中央銀行（ECB）の日次ユーロ外国為替参考レートを読み込みます。これは銀行、税務当局、会計士が使用するものと同じ公表系列です。ECBがレートを公表している通貨間で金額を換算し、通貨ペアの推移も表示します。API キーもアカウントもレート制限もありません。ECBがデータを公開しているためです。2つのファイルはご利用のマシンにキャッシュされるので、初回のダウンロード後はすべての回答が即座に返り、飛行機内でもサーバーは動作します。ECBのレートは1日1回公表され、日曜日には金曜日のレートが適用されるため、すべての回答に使用したレートの日付が記載されます。

theluckystrike によって開発されました。

公式 MCP Registry に登録されています（io.github.theluckystrike/currency-converter-ecb-rates-daily-keyless）。

AI Product Index に掲載されています - mcp.zovo.one/s/currency で利用できるライブのリモートエンドポイント、無料プラン、サインアップ不要です。

60秒でインストール

@theluckystrike/mcp-currency の npm 公開は保留中です。それまでは、.mcpb ワンクリックバンドルか、クローンしてビルドする方法をご利用ください。 どちらも以下で動作確認済みです。

ワンクリック（.mcpb）：最新リリースから currency.mcpb をダウンロードし、Claude Desktop でダブルクリックします： https://github.com/theluckystrike/mcp-servers/releases/latest

（claude_desktop_config.json）：

{
  "mcpServers": {
    "currency": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-currency"]
    }
  }
}

Claude Code：

claude mcp add currency -- npx -y @theluckystrike/mcp-currency

（.cursor/mcp.json）：

{
  "mcpServers": {
    "currency": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-currency"]
    }
  }
}

上記の npx 形式は、パッケージが公開されるとすぐに使用できるようになります。それまでは、上記の .mcpb バンドルを使うか、 次の3つのコマンドだけでソースからビルドしてください：

git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers
npm install
npm run build -w packages/mcp-license -w servers/currency

次に、クライアントの command を node に設定し、引数として servers/currency/dist/index.js の絶対パスを指定します。

Pro モードで実行するには、同じ設定ブロックで MCP_LICENSE_KEY を設定するか、キーを使って license_activate を一度呼び出します。

ツール

ツール	機能
rates_latest	最新のECB参考レートを、任意の基準通貨に換算して返します。quotes を指定すると、対象を絞り込めます。
convert	今日または過去の日付のレートで、2つの通貨間の金額を換算します。レート、レートの日付、丸め方法を示します。
convert_many	1つの金額を、同じレートの日付を使って複数の通貨に一括換算します。
fx_rates_for	経費トラッカーの expense_to_invoice が受け取る fx_rates オブジェクトと、レートの日付を返します。
rate_history	指定した期間における通貨ペアの最小値、最大値、平均値、変動を返します。
rate_on	指定した日付のレートを返します。その日に公表レートがない場合は、それ以前に公表された最新のレートを使い、その旨を示します。両方向（rate と inverse_rate）のレートを返し、published_direction にはECB自身がどちらの向きで通貨ペアを公表しているかを示すため、逆数が公表値として伝えられることはありません。
currencies_list	ECBがレートを公表しているすべての通貨と、それぞれのユーロレートおよび小数点以下の桁数を返します。
cache_status	キャッシュの内容、経過時間、次回の更新時期、保存場所を返します。
license_status / license_activate	Pro キーを確認または有効化します。オフラインで検証できます。

リソース fx://latest は、キャッシュされたレートを JSON として公開します。プロンプト convert_invoice_lines は、 経費トラッカー -> 通貨 -> 請求書の一連の処理を1ステップで実行します。

Free と Pro の比較

	Free	Pro（$19、買い切り）
最新レート、convert、convert_many、fx_rates_for	はい、無制限	はい、無制限
通貨	ECB がレートを公表する30種類以上すべて	ECB がレートを公表する30種類以上すべて
レート履歴	1回の呼び出しにつき最大90日、過去90日まで。より広い期間を指定すると範囲が短縮され、その上限が明示されます	期間は無制限、1999-01-04までさかのぼれます
rate_on	過去90日	1999-01-04以降の任意の日付
オフラインキャッシュ	はい	はい

拒否された履歴期間のリクエストには、その理由と実行すべき正確な短縮後の呼び出しが返されます。表が黙って切り詰められることはなく、トランスポートエラーが返されることもありません。

Pro を入手：https://mcp.zovo.one/buy/currency（または、バンドル全体を$39で入手：https://mcp.zovo.one/buy/bundle）

連携先

• expense-tracker の expense_to_invoice は、target_currency と fx_rates オブジェクトを受け取り、複数通貨の経費を1つの請求書通貨にまとめます。ただし、レートを取得したり、作り出したりはしません。ここで fx_rates_for {target, currencies} を使うと、まさにそのオブジェクトが返されます。「Nova に USD で請求する」を、ユーザーが為替レートを一切入力せずに最初から最後まで実行できます。
• invoice の請求書で使用できる通貨は1つです。先に換算してから請求書を発行し、返された invoice_note（「2026-09-02 の ECB 参照レートで換算」）を文書に記載すれば、クライアントが確認できます。

expense_to_invoice {project, from, to}          -> which currencies are actually present
fx_rates_for {target: "USD", currencies: [...]} -> {"EUR": 1.0812, "GBP": 1.2717}, rate date
expense_to_invoice {..., target_currency: "USD", fx_rates: {...}} -> one currency, every line annotated
invoice_create {currency: "USD", items: [...]}  -> the document

レートの仕組み

• 参照元：ECB のユーロ外国為替参照レート、eurofxref-daily.xml および eurofxref-hist.xml。
• TARGET 営業日の中央ヨーロッパ時間16:00頃に公表されます。週末、1月1日、聖金曜日、復活祭の月曜日、5月1日、12月25日および26日はレートがありません。
• レートがない日付を指定すると、すべての銀行で使われている慣例に従って、その日付以前に公表された最新のレートが返されます。また、どの日付のレートが適用されたか、その理由も回答に記載されます。キャッシュ範囲内でレートのない日付は週末または TARGET の祝日として明示されます。キャッシュ内の最新日より後の日付は、まだ公表されていないと報告され、キャッシュ内の最新日と、この呼び出しで ECB にレートを確認しに行ったかどうかも示されます。
• ECB はすべての通貨をユーロに対するレートで公表するため、USD/PLN レートはクロスレートです。比率を計算して最大精度で乗算し、途中では丸めず、最後に対象通貨の最小通貨単位に合わせて丸めます。回答には2つの数値が含まれます。rate_exact は乗数、rate は読みやすいように小数点以下6桁に丸めた同じレートです。小数点以下6桁の rate から手計算で再計算すると、最小通貨単位で1～2単位の差が出ることがあります。特にレートが1から大きく離れている通貨ペアでは差が大きくなります（1,000,000 VND は KWD 12.000 ではなく KWD 11.667 です）。
• 結果は、対象通貨固有の ISO 4217 最小通貨単位に合わせて丸められます。JPY は整数、BHD は小数点以下3桁になります。
• これらは会計および報告用の参照レートです。実際の取引レートではないため、銀行のレートとは異なります。

プライバシー

すべてのデータはローカルに保持されます。このサーバーが行うネットワークリクエストは、公開レートファイル2つを取得するための www.ecb.europa.eu へのリクエストだけです。しかも、ローカルのコピーが6時間（毎日のレート）または24時間（履歴）を超えて古い場合に限られます。金額、通貨、マシンに関する情報が外部に送信されることはありません。キャッシュは ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/currency/ に保存されます。このディレクトリを削除すると、サーバーがリセットされます。外部へのアクセスが制限されている場合は、ECB_BASE_URL を設定して独自のミラーを指定してください。

MIT ライセンスです。サポート：[email protected]。theluckystrike によって作成されました。

これらのドキュメントを MCP サーバーとして使用する

任意の MCP クライアント（Claude、Cursor、Windsurf、VS Code）で、インストールせずに GitMCP 経由でこのリポジトリのドキュメントを直接読み取れます。

• Docs MCP URL：https://gitmcp.io/theluckystrike/mcp-currency