CurrencyFreaks

CurrencyFreaks MCP サーバー

CurrencyFreaks の公式 MCP サーバーです。1000 種類以上の法定通貨、暗号通貨、貴金属について、リアルタイムおよび過去の為替レートと通貨換算を行う 7 つの MCP ツールを提供します。AI アシスタントが自然な英語でレートを尋ねると、MCP サーバーが API 呼び出しを処理します。

Claude Desktop、Claude Code、Cursor、Windsurf、VS Code、Cline、Codex、およびその他の MCP 互換クライアントで利用できます。

項目	値
パッケージ	@currencyfreaks/mcp
トランスポート	stdio
Node.js	>=18

クイックスタート

1. CurrencyFreaks の無料 API キーを取得します — 月 1,000 リクエストまで利用でき、カード登録は不要です。

2. Cursor ユーザーはワンクリックでインストールできます。

   

3. それ以外の方は、MCP クライアントの設定に以下を追加します（正確なファイルパスはクライアント別のインストール方法を参照してください）。

{
  "mcpServers": {
    "currencyfreaks": {
      "command": "npx",
      "args": ["-y", "@currencyfreaks/mcp"],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

4. クライアントを再起動します。

5. 動作を確認します。「現在の EUR から USD への為替レートは？」と尋ねてください。

目次

• クイックスタート
• クライアント別のインストール方法
• 動作確認
• ツールリファレンス
• プランの要件
• プロンプトの例
• 回答例とツール出力
• エラーコード
• 仕組み
• 環境変数
• ソースからのビルド
• トラブルシューティング
• 料金
• リンク
• ライセンス

クライアント別のインストール方法

要件

• Node.js 18 以降
• ターミナルで npx を使用できること
• CurrencyFreaks API キー — 無料で登録

Claude Desktop

claude_desktop_config.json に追加します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "currencyfreaks": {
      "command": "npx",
      "args": ["-y", "@currencyfreaks/mcp"],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

保存後、Claude Desktop を再起動します。

Claude Code

claude mcp add currencyfreaks --env CURRENCYFREAKS_API_KEY=<YOUR_API_KEY> -- npx -y @currencyfreaks/mcp

サーバーを追加した後、新しい Claude Code セッションを開始します。

Cursor

ワンクリックでインストール：

または、.cursor/mcp.json に手動で追加します。

{
  "mcpServers": {
    "currencyfreaks": {
      "command": "npx",
      "args": ["-y", "@currencyfreaks/mcp"],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

保存後、Cursor を再起動します。

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "currencyfreaks": {
      "command": "npx",
      "args": ["-y", "@currencyfreaks/mcp"],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

保存後、Windsurf を再起動します。

VS Code / GitHub Copilot

VS Code の settings.json に追加します。

{
  "mcp": {
    "servers": {
      "currencyfreaks": {
        "command": "npx",
        "args": ["-y", "@currencyfreaks/mcp"],
        "env": {
          "CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
        }
      }
    }
  }
}

保存後、VS Code を再起動します。

Cline

MCP Servers パネルを開き、Configure → Advanced MCP Settings を選択します。cline_mcp_settings.json に追加します。

{
  "mcpServers": {
    "currencyfreaks": {
      "command": "npx",
      "args": ["-y", "@currencyfreaks/mcp"],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

保存後、Cline を再起動します。

Codex CLI

codex mcp add currencyfreaks --env CURRENCYFREAKS_API_KEY=<YOUR_API_KEY> -- npx -y @currencyfreaks/mcp
codex mcp list

サーバーを追加した後、新しい Codex セッションを開始します。

その他の MCP クライアント

次の設定を使用します。

{
  "command": "npx",
  "args": ["-y", "@currencyfreaks/mcp"],
  "env": {
    "CURRENCYFREAKS_API_KEY": "<YOUR_API_KEY>"
  }
}

動作確認

セットアップ後、以下を試してください：

プロンプト	期待されるツール
現在のEURからUSDへの為替レートはいくらですか？	symbols=EUR を指定した get_latest_rates
500 USDをPKRに換算してください。	convert_currency
2026-01-15時点で1,000 GBPはいくらのJPYでしたか？	date を指定した convert_currency
2020年1月2日のEUR/USDレートはいくらでしたか？	get_historical_rates
2026年8月第1週のUSDからINRへの日次レートを表示してください。	get_time_series
6月1日以降、円はドルに対してどれだけ変動しましたか？	get_fluctuation
ネパール・ルピーの通貨コードは何ですか？	search=nepal を指定した list_currencies
IP 182.186.18.9 の現地通貨で50 USDはいくらですか？	ip_to_currency

ツールリファレンス

7つのツールはすべて、CurrencyFreaks v2.0 REST API をラップしています。symbols を受け取るツールでは、通貨コードを大文字・小文字を区別しないカンマ区切りのリスト（例：EUR,GBP,PKR）で指定できます。コードを調べるには list_currencies を使用してください。法定通貨、暗号資産、金属を含む1,000種類以上の通貨があります。

貴金属には ISO 4217 コードを使用します：XAU（金）、XAG（銀）、XPT（プラチナ）、XPD（パラジウム）。API は精度を保つため、すべてのレートと金額を文字列として返します。

list_currencies

GET /v2.0/currency-symbols（簡易版）または GET /v2.0/supported-currencies（詳細版）— 対応通貨のカタログです。API キーは不要です。

パラメーター	必須	説明
search	いいえ	コード、名称、または（detailed が指定されている場合は）国名に対して、大文字・小文字を区別せず部分一致で検索します。例：rupee、PK、bitcoin
detailed	いいえ	true を指定すると、通貨ごとに国、ステータス（AVAILABLE／DEPRECATED）、過去データの範囲（availableFrom／availableUntil）、国旗アイコンを返します。デフォルトは false です。search と組み合わせられます。詳細カタログ全体のサイズは約270 KBです。

get_latest_rates

GET /v2.0/rates/latest — 1つ以上の通貨について、基準通貨に対する最新レートを取得します。更新頻度はプランによって異なります。Developer（無料）では1日ごと、Starterでは1時間ごと、Growthでは10分ごと、Professional以上では60秒ごとです。

パラメーター	必須	説明
symbols	いいえ	カンマ区切りの通貨コードです。省略すると1,000種類以上のすべての通貨が対象になります。
base	いいえ	基準通貨コードです。デフォルトは USD です。有料プランのみ利用できます。

convert_currency

GET /v2.0/convert/latest、または date を指定した場合は GET /v2.0/convert/historical — 2つの通貨間で金額を換算します。有料プランのみ利用できます。

パラメーター	必須	説明
from	はい	換算元の通貨コード
to	はい	換算先の通貨コード
amount	いいえ	換算する金額です。0より大きい値を指定します。デフォルトは 1.0 です。
date	いいえ	YYYY-MM-DD。指定日のレートで換算します。省略すると最新レートが使用されます。

get_historical_rates

GET /v2.0/rates/historical — 指定した過去の日付のレートを取得します。主要な法定通貨は1984-11-28までさかのぼって取得できます。新しい通貨と暗号資産のデータは、それぞれの上場日から利用できます。有料プランのみ利用できます。

パラメーター	必須	説明
date	はい	YYYY-MM-DD
symbols	いいえ	カンマ区切りの通貨コードです。省略するとすべての通貨が対象になります。
base	いいえ	基準通貨コードです。デフォルトは USD です。

get_time_series

GET /v2.0/timeseries — 2つの日付の間の日次レートを、1日につき1件取得します。Professional以上のプランで利用できます。

パラメーター	必須	説明
startDate	はい	YYYY-MM-DD
endDate	はい	YYYY-MM-DD
symbols	いいえ	カンマ区切りの通貨コードです
base	いいえ	基準通貨コードです。デフォルトは USD です。

get_fluctuation

GET /v2.0/fluctuation — 2つの日付間で各通貨がどのように変動したかを示します。開始レート、終了レート、絶対変動額、変動率を確認できます。Professional プラン以上が必要です。

符号の規則：change は startRate - endRate です。change が正の場合、レートは下落しています（シンボル通貨は基準通貨に対して強くなっています）。change が負の場合、レートは上昇しています（シンボル通貨は弱くなっています）。

パラメーター	必須	説明
startDate	はい	YYYY-MM-DD
endDate	いいえ	YYYY-MM-DD。デフォルトは今日の前日です。
symbols	いいえ	カンマ区切りの通貨コード
base	いいえ	基準通貨コード。デフォルトは USD です。

ip_to_currency

GET /v2.0/iptocurrency — IP アドレスの位置情報から現地通貨を特定し、金額をその通貨に換算します。対象通貨は to フィールドに返されます。Growth プラン以上が必要です。

パラメーター	必須	説明
from	はい	換算元の通貨コード
ip	いいえ	IPv4 または IPv6 アドレス。省略すると、呼び出し元自身の IP が使用されます。
amount	いいえ	換算する金額。デフォルトは 1.0 です。

プラン要件

機能	最低プラン
list_currencies	なし（API キー不要）
デフォルトの USD 基準通貨での get_latest_rates	Developer（無料）
すべてのツールでの base パラメーター	Starter
convert_currency	Starter
get_historical_rates	Starter
ip_to_currency	Growth
get_time_series	Professional
get_fluctuation	Professional

プランの上限を超える呼び出しは、案内を含む 402 エラーを返します（エラーコードを参照）。

プロンプトの例

現在のレート

• 現在の EUR から USD への為替レートはいくらですか？
• ユーロに対する GBP、JPY、CHF の最新レートを教えてください。
• 現在、ビットコインは USD でいくらですか？
• 金の価格はユーロでいくらですか？

換算

• 250 USD をインドルピーに換算してください。
• 1,200 ユーロは何円ですか？
• 2025-12-31 時点で、500 GBP は USD でいくらでしたか？

過去のデータ

• 2020 年 1 月 2 日の USD から PKR へのレートはいくらでしたか？
• 2026 年第 1 四半期の EUR/USD の日次レートを表示してください。
• 過去 30 日間のドルに対するポンドとユーロの推移を比較してください。

価格の変動

• 1 月 1 日以降、トルコリラはドルに対してどれくらい下落しましたか？
• 今月、ETH は USD に対して上昇しましたか、それとも下落しましたか？また、どれくらい変動しましたか？

通貨の検索

• カザフスタン・テンゲの通貨コードは何ですか？
• CurrencyFreaks はアフリカのどの通貨に対応していますか？
• ナイジェリア・ナイラの過去のデータはどこまで遡れますか？

回答とツール出力の例

テキストの回答はクライアントが返す可能性のある内容を示しています。正確な表現はモデルによって異なります。JSON ブロックは生のツール出力です。

最新レート

プロンプト： ドルに対する最新の EUR、GBP、PKR のレートを教えてください。

回答例： 2026-08-25 13:26 UTC 時点で、1 USD で 0.9279 EUR、0.8173 GBP、または 281.62 PKR を購入できます。

{
  "date": "2026-08-25 13:26:00+00",
  "base": "USD",
  "rates": {
    "EUR": "0.9278605451274349",
    "GBP": "0.8172754173817152",
    "PKR": "281.6212943333344",
    "USD": "1.0"
  }
}

換算

プロンプト： 500 USD を PKR に換算してください。

回答例： 500 USD は、レート 281.683 で 140,841.48 PKR です。

{
  "date": "2026-08-25 15:22:00+00",
  "from": "USD",
  "to": "PKR",
  "rate": "281.683",
  "givenAmount": "500.0",
  "convertedAmount": "140841.475"
}

変動

プロンプト： 2026 年 6 月 1 日から 6 月 15 日までの間に、パキスタン・ルピーはポンドに対してどのように変動しましたか？

回答例： PKR はポンドに対して強くなり、1 GBP あたり 254.331 から 243.874 になりました。変動幅は 10.457（4.11％）です。

{
  "startDate": "2026-06-01",
  "endDate": "2026-06-15",
  "base": "GBP",
  "rateFluctuations": {
    "PKR": {
      "startRate": "254.331",
      "endRate": "243.874",
      "change": "10.457",
      "percentChange": "4.11"
    }
  }
}

通貨の検索

プロンプト： ネパール・ルピーの通貨コードは何ですか？

回答例： ネパール・ルピーの通貨コードは NPR です。

{
  "count": 6,
  "currencies": {
    "SCR": "Seychellois Rupee",
    "MUR": "Mauritius Rupee",
    "INR": "Indian Rupee",
    "PKR": "Pakistani Rupee",
    "LKR": "Sri Lankan Rupee",
    "NPR": "Nepalese Rupee"
  }
}

エラーコード

ツールの呼び出しによってサーバーがクラッシュすることはありません。上流で発生したエラーは、error、code、message、guidance フィールドを含む構造化されたツール結果として返されるため、クライアントはステータスコードをそのまま返すのではなく、何が問題だったのかを説明できます。

コード	意味
400	API キーが指定されていない、またはパラメーターが無効です（通貨コード、日付形式、金額、IP アドレスが不正）
401	API キーが無効、または停止されています。クライアント設定の CURRENCYFREAKS_API_KEY を確認してください
402	現在のプランに含まれていない機能です。プラン要件を参照してください
404	リクエストした通貨、日付、または期間のレートが見つかりません
429	月間リクエスト枠を使い切りました。プランをアップグレードするか、リセットをお待ちください
499	上流 API へのリクエストがタイムアウトしました（CURRENCYFREAKS_REQUEST_TIMEOUT_MS を参照）
502	サーバーが上流 API に接続できませんでした

無効なキーに対するエラー結果の例：

{
  "error": "Invalid Api Access Exception",
  "code": 401,
  "message": "Provided API key is invalid. [Contact tech. support for assistance at [email protected]]",
  "guidance": "The API key is invalid or inactive. Check CURRENCYFREAKS_API_KEY in your MCP client config and confirm the key is active on the CurrencyFreaks dashboard."
}

仕組み

これは CurrencyFreaks v2.0 REST API をラップする stdio MCP サーバーです。

実行時の流れ：

1. MCP クライアントが npx を使ってサーバープロセスを起動します。
2. クライアントがツール一覧を読み込みます。
3. プロンプトがツールに一致すると、クライアントがそのツールを呼び出します。
4. サーバーが入力を検証し、CurrencyFreaks を呼び出して、構造化された JSON を返します。

API キーは呼び出しごとに環境変数から読み込まれ、apikey クエリパラメーターとして送信されます。list_currencies が使用するカタログエンドポイントは公開されているため、キーを設定する前でもこのツールを利用できます。

環境変数

変数	必須	デフォルト	説明
CURRENCYFREAKS_API_KEY	はい		CurrencyFreaks API キー
CURRENCYFREAKS_REQUEST_TIMEOUT_MS	いいえ	15000	上流リクエストのタイムアウト（ミリ秒）

ソースからビルドする

git clone https://github.com/CurrencyFreaks/currencyfreaks-mcp.git
cd currencyfreaks-mcp
npm install
npm run build

直接実行する：

CURRENCYFREAKS_API_KEY=<YOUR_KEY> node dist/cli.js

MCP Inspector で調べる：

CURRENCYFREAKS_API_KEY=<YOUR_KEY> npx @modelcontextprotocol/inspector node dist/cli.js

トラブルシューティング

更新後もクライアントに古いツール一覧が表示される： クライアントを再起動し、最新の npm バージョンが読み込まれていることを確認してください。

400「Please provide API Key」： MCP クライアント設定の env ブロックに CURRENCYFREAKS_API_KEY が設定されていません。

401 エラー： キーが間違っているか、停止されています。CurrencyFreaks ダッシュボードからもう一度コピーしてください。

402 エラー： このツールには上位プランが必要です。プラン要件を参照してください。Developer（無料）プランでは、デフォルトの USD 基準通貨を使った get_latest_rates と list_currencies のみ利用できます。

404「Rates of provided currency X are available from A to B」： 指定した日付が、その通貨のデータ範囲外です。list_currencies を search=X と detailed=true を指定して呼び出し、availableFrom と availableUntil を確認してください。

応答が非常に大きい： レート取得ツールには必ず symbols を、list_currencies には必ず search を指定してください。指定しない場合、API は 1000 種類以上の通貨をすべて返します。

499 タイムアウト： 上流 API が時間内に応答しませんでした。CURRENCYFREAKS_REQUEST_TIMEOUT_MS を大きくしてください（デフォルト：15000 ms）。

料金

Developer プランは無料で、月あたり 1,000 件のリクエストを利用でき、カードの登録は不要です。有料プランでは、基準通貨の選択、通貨換算、過去データ、時系列データ、変動率、IP アドレスからの通貨判定が追加され、更新間隔も短くなります。CurrencyFreaks の料金ページを参照してください。

リンク

• CurrencyFreaks のウェブサイト
• API ドキュメント
• 対応通貨
• 料金
• 無料で登録
• GitHub リポジトリ

ライセンス

MIT