Currency Exchange & Crypto Rates

通貨交換・暗号資産レート MCP サーバー

Model Context Protocol を通じて、リアルタイムの外国為替レートと暗号資産価格を取得する通貨交換 MCP サーバーです。60 種類以上の法定通貨と 30 種類以上の暗号資産を相互に交換できます。複数ソースのフェイルオーバー、スマートな通貨解決、一括換算、過去のレート照会に対応しています。上流データソースの API キーは不要です。

ツール

convert_currency

対応する法定通貨または暗号資産のペア間で金額を換算します。

入力：

{ "amount": 100, "from": "USD", "to": "INR" }

出力：

{
  "amount": 100,
  "from": "USD",
  "to": "INR",
  "result": 8312,
  "rate": 83.12,
  "inverseRate": 0.012031,
  "timestamp": "2026-02-14T12:00:00.000Z",
  "source": "exchangerate-api",
  "cached": false
}

自然言語でも利用できます：

{ "amount": 1, "from": "bitcoin", "to": "rupees" }

batch_convert

1 回の呼び出しで、ある通貨の金額を複数の通貨に換算します。個別に複数回換算するより効率的です。

入力：

{ "amount": 1000, "from": "USD", "to": ["EUR", "GBP", "INR", "JPY", "BTC"] }

出力：

{
  "amount": 1000,
  "from": "USD",
  "conversions": [
    { "to": "EUR", "result": 920, "rate": 0.92, "inverseRate": 1.086957, "source": "exchangerate-api", "cached": false },
    { "to": "GBP", "result": 790, "rate": 0.79, "inverseRate": 1.265823, "source": "exchangerate-api", "cached": false },
    { "to": "INR", "result": 83120, "rate": 83.12, "inverseRate": 0.012031, "source": "exchangerate-api", "cached": false },
    { "to": "JPY", "result": 149500, "rate": 149.5, "inverseRate": 0.006689, "source": "exchangerate-api", "cached": false },
    { "to": "BTC", "result": 0.02, "rate": 0.00002, "inverseRate": 50000, "source": "coinbase", "cached": false }
  ],
  "timestamp": "2026-02-14T12:00:00.000Z"
}

1 回の呼び出しで最大 50 件の換算先に対応します。重複する通貨と換算元と同じ通貨は自動的に除外されます。

get_exchange_rates

基準通貨に対する複数の換算先通貨の現在の為替レートを取得します。

入力：

{ "base": "USD" }

デフォルトでは、上位 20 通貨（USD、EUR、GBP、JPY、INR、AED、CAD、AUD、CHF、CNY、SGD、HKD、KRW、BRL、MXN、ZAR、TRY、THB、SAR、BTC）のレートを返します。換算先を指定することもできます：

{ "base": "BTC", "targets": ["USD", "EUR", "INR", "GBP"] }

出力：

{
  "base": "BTC",
  "rates": {
    "USD": 51234.56,
    "EUR": 47345.12,
    "INR": 4258567.12,
    "GBP": 40567.89
  },
  "timestamp": "2026-02-14T12:00:00.000Z",
  "source": "coinbase",
  "cached": false
}

get_historical_rate

単一の日付または日付範囲（最大 365 日）の過去の為替レートを取得します。

単一の日付：

{ "base": "USD", "target": "INR", "date": "2025-01-15" }

出力：

{
  "base": "USD",
  "target": "INR",
  "date": "2025-01-15",
  "rate": 86.45,
  "source": "frankfurter",
  "cached": false
}

日付範囲：

{ "base": "USD", "target": "EUR", "startDate": "2025-01-01", "endDate": "2025-01-31" }

出力：

{
  "base": "USD",
  "target": "EUR",
  "period": { "startDate": "2025-01-01", "endDate": "2025-01-31" },
  "rates": [
    { "date": "2025-01-02", "rate": 0.9234 },
    { "date": "2025-01-03", "rate": 0.9241 }
  ],
  "change": {
    "high": 0.9312,
    "low": 0.9189,
    "average": 0.9248,
    "changePct": 0.94
  },
  "source": "frankfurter",
  "cached": false
}

対応通貨

法定通貨（60 種類以上）

主な通貨	湾岸・中東	アジア太平洋	南北アメリカ	ヨーロッパ	アフリカ
USD	AED	INR	BRL	EUR	ZAR
EUR	SAR	JPY	MXN	GBP	NGN
GBP	KWD	CNY	ARS	CHF	KES
JPY	QAR	SGD	CLP	SEK	EGP
AUD	BHD	HKD	COP	NOK	GHS
CAD	OMR	KRW	PEN	DKK	MAD
CHF	JOD	TWD	UYU	PLN	TND
CNY	ILS	THB		CZK
INR	EGP	MYR		HUF
	IQD	PHP		RON
	IRR	IDR		BGN
	LBP	VND		ISK
		BDT		RUB
		PKR		UAH
		LKR		HRK

暗号資産（30 種類）

シンボル	名前	シンボル	名前
BTC	Bitcoin	XRP	Ripple
ETH	Ethereum	LTC	Litecoin
SOL	Solana	BCH	Bitcoin Cash
DOGE	Dogecoin	ATOM	Cosmos
ADA	Cardano	NEAR	NEAR Protocol
DOT	Polkadot	APT	Aptos
AVAX	Avalanche	ARB	Arbitrum
MATIC	Polygon	OP	Optimism
LINK	Chainlink	SHIB	Shiba Inu
UNI	Uniswap	USDT	Tether
BNB	BNB	USDC	USD Coin
XLM	Stellar	ALGO	Algorand
FIL	Filecoin	AAVE	Aave
CRO	Cronos	PEPE	Pepe
SUI	Sui	TRX	Tron

スマートな通貨解決

ISO 4217 コード、暗号資産シンボル、自然言語を受け付けます：

入力	解決結果
USD、dollars、bucks	USD
EUR、euro、euros	EUR
GBP、pounds、sterling	GBP
INR、rupees、rupee	INR
JPY、yen	JPY
CNY、yuan、renminbi、rmb	CNY
AED、dirham、dirhams	AED
SAR、riyal、riyals	SAR
BTC、bitcoin	BTC
ETH、ethereum、ether	ETH
SOL、solana	SOL
DOGE、dogecoin	DOGE

データソース

データ	プライマリ	フォールバック
法定通貨レート（現在）	ExchangeRate-API（160 通貨、毎日更新）	fawazahmed0/exchange-api（CDN、150 以上の通貨）
暗号資産レート（現在）	Coinbase Public API（200 以上のコイン、リアルタイム）	CoinGecko（10K 以上のコイン、API キー不要）
過去のレート	Frankfurter.app（ECB データ、33 通貨、1999 年まで遡及）	fawazahmed0 の日付エンドポイント

すべての上流 API は認証不要です（API キーは必要ありません）。

機能

• 複数ソースのフォールバック — プロバイダー間で自動的にフェイルオーバーします
• 法定通貨から法定通貨、暗号資産から法定通貨、法定通貨から暗号資産、暗号資産から暗号資産への換算
• USD クロスレートによる暗号資産間の換算（例：BTC から ETH）
• 一括換算 — 1 回の呼び出しで最大 50 通貨に換算できます
• スマートな通貨解決 — 自然言語、ISO コード、暗号資産のシンボルに対応
• 時系列データと変動統計（高値、安値、平均、変動率）を含む過去のレート
• TTL を段階的に設定した LRU キャッシュ — 法定通貨は 30 分、暗号資産は 2 分、過去のレートは 24 時間
• ドメインごとのレート制限（同じ上流 API へのリクエスト間隔は 1.5 秒）
• すべてのツール入力を Zod スキーマで検証
• 日付検証 — 将来の日付、無効な形式、365 日を超える範囲を拒否します

料金

イベント	説明	価格（USD）
currency-convert	1 通貨ペアの換算	$0.003
batch-convert	一度に最大 50 通貨に換算	$0.008
exchange-rates	為替レートの照会	$0.003
historical-rate	過去のレートの照会	$0.008

制限事項

• 暗号資産の過去のレート：未対応です — Frankfurter と fawazahmed0 が扱うのは法定通貨のみです
• Frankfurter の対象範囲：ECB の約 33 通貨のみです — 湾岸諸国の通貨（AED、SAR、KWD、QAR）の過去のレートには、fawazahmed0 のフォールバックを使用します
• 法定通貨レートの鮮度：ExchangeRate-API は毎日更新され、リアルタイムではありません
• 暗号資産レートの鮮度：上流 API の制限を守るため、2 分間キャッシュされます
• 時系列データ：Frankfurter が対応する（ECB）通貨のみ利用できます
• 上流 API のレート制限：API キー不要の CoinGecko は約 10 リクエスト/分、Coinbase は約 10 リクエスト/秒です
• リクエストごとのレスポンスサイズ上限は 1MB です
• 上流ドメインごとに 1.5 秒あたり 1 リクエストに制限されます

使用方法

MCP エンドポイント： POST /mcp

# Convert 100 USD to INR
curl -X POST https://your-actor.apify.actor/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_API_TOKEN" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"convert_currency","arguments":{"amount":100,"from":"USD","to":"INR"}},"id":1}'

# Get BTC exchange rates
curl -X POST https://your-actor.apify.actor/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_API_TOKEN" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_exchange_rates","arguments":{"base":"BTC","targets":["USD","EUR","INR"]}},"id":2}'

# Historical rate for a specific date
curl -X POST https://your-actor.apify.actor/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_APIFY_API_TOKEN" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"get_historical_rate","arguments":{"base":"USD","target":"INR","date":"2025-01-15"}},"id":3}'

ローカルでの実行

npm install
npm run start:dev

サーバーは http://localhost:3000/mcp で起動します。

AI クライアントへの接続

MCP クライアントの設定（Claude Desktop、Cline、Cursor など）に以下を追加します。

{
  "mcpServers": {
    "currency-exchange": {
      "url": "https://vector384--currency-exchange-mcp.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_API_TOKEN"
      }
    }
  }
}

YOUR_APIFY_API_TOKEN をお使いの Apify API トークンに置き換えてください。

デプロイ

apify login
apify push

プッシュ後、Apify プラットフォームでスタンバイモードを設定してください。

FAQ

上流の為替レートプロバイダーを利用するのに API キーは必要ですか？ いいえ。5 つすべてのデータソース（ExchangeRate-API、fawazahmed0、Frankfurter、Coinbase、CoinGecko）は公開されており、無料です。デプロイした Actor には Apify API トークンのみ必要です。

複数ソースのフェイルオーバーはどのように機能しますか？ 各リクエストでは、まずプライマリプロバイダーを試します。失敗するかタイムアウトすると、サーバーは自動的にフォールバックプロバイダーで再試行します。法定通貨：ExchangeRate-API → fawazahmed0。暗号資産：Coinbase → CoinGecko。過去のレート：Frankfurter → fawazahmed0。

2 種類の暗号資産（例：BTC と ETH）間で換算できますか？ はい。暗号資産間の換算では、USD クロスレートを自動的に使用します。

レートはどのくらい新しいですか？ 法定通貨レートは毎日更新されます。暗号資産レートは 2 分間キャッシュされます。過去のレートは 24 時間キャッシュされます。

暗号資産の過去のレートには対応していますか？ いいえ。過去のデータソース（Frankfurter/ECB と fawazahmed0）が対象としているのは法定通貨のみです。

ローカルで実行するにはどうすればよいですか？ npm install && npm run start:dev を実行すると、MCP エンドポイントを http://localhost:3000/mcp で利用できます。