Crypto Market Data

暗号資産市場データ MCP サーバー

Model Context Protocol に対応した読み取り専用サーバーです。CCXT を通じて、あらゆる AI エージェント（Claude、Cursor、Cline、Windsurf など）に、100 以上の取引所のリアルタイム暗号資産市場データを提供します。API キーは不要です。すべて公開エンドポイントを使用します。

対応取引所：bybit、binance、okx、hyperliquid、gate、kucoin（SUPPORTED_EXCHANGES に CCXT ID を追加すれば、さらに追加できます）。

MCPize 経由で接続

ローカルにインストールせず、すぐにこの MCP サーバーを利用できます。

npx -y mcpize connect @eliasfire617/crypto-market-data --client claude

こちらから接続することもできます：https://mcpize.com/mcp/crypto-market-data

ツール（13）

検索

ツール	機能
list_exchanges	対応している取引所を確認します
get_capabilities	各取引所が対応するデータの一覧を表示します（ネットワーク接続なし）
search_symbols	コインの正確なシンボル形式を検索します

市場データ

ツール	機能
get_price	最終価格と24時間の統計情報
get_order_book	板の最良買い気配／売り気配
get_ohlcv	直近の OHLCV ローソク足
get_recent_trades	最新の公開取引

デリバティブ

ツール	機能
get_funding_rate	現在の無期限契約の資金調達率
get_funding_rate_history	過去の資金調達率
compare_funding	複数の取引所の資金調達率と裁定スプレッド
get_open_interest	現在の建玉
get_long_short_ratio	全体のロング／ショート口座比率（Binance）
get_liquidations	直近の公開清算情報（対応は限定的）

compare_funding はこのサーバーの強みです。資金調達率の裁定機会（どの取引所の支払いが最も高いか、または低いか）を、1 回の並行呼び出しで提示します。 比較前にレートは**年率換算（apr_pct）**されます。取引所によって資金調達の頻度が異なるため（Hyperliquid は1時間ごと、その他は8時間ごと）、未加工のレートは比較できません。

データだけでなく分析も必要ですか？ 関連サーバーの Crypto Derivatives Intelligence はこのデータを基に、手数料を差し引いた資金調達キャリーの機会（損益分岐までの日数、執行可能な板の厚み）、建玉と価格の乖離、清算ゾーン、ポジションの極端な偏り、市場レジームの分類を、それぞれ1回のツール呼び出しで提供します。

堅牢性

デモではなく、本番運用を想定して構築されています。

• 一時的なネットワークエラーに対する指数バックオフ付きリトライ（3 回）。
• 呼び出しが停止しないよう、リクエストごとおよび全体のタイムアウト（10秒／25秒）を設定しています。
• 機能ガード：取引所が対応していないメソッドは呼び出さず、対応している取引所を一覧表示した明確なエラーを返します（get_capabilities を参照）。
• クラッシュの代わりに構造化エラー（{"error": {type, message, retryable, supported_exchanges}}）を返すため、エージェントは常に解析可能な応答を受け取れます。
• TTL 応答キャッシュ（再度の呼び出しを約660倍高速化し、レート制限を緩和）。
• すべてのツールで入力を検証し、上限値を適用します。
• 取引所を確実にクリーンアップし、ログはstderr のみに出力します（stdio トランスポートでも安全）。

ローカルで実行

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# stdio transport (Claude Desktop, Cursor, Cline) — local, no auth:
python server.py

# OR streamable HTTP (hosted / remote) — API-key auth + rate limiting ON:
python server.py --http                 # binds :8000 (override with PORT=8799)

認証と課金（HTTP モード）

ホストされた HTTP トランスポートはアクセス制限付きです。これにより課金が可能になります。ローカルの stdio は、単一ユーザーでの開発向けに開放されています。

• クライアントは Authorization: Bearer <api-key> を送信します。

• 各キーは client_id とティアに対応します。不明または未指定のキーには 401 が返されます。

• ティア（auth.py → TIERS）では、1 分あたりのレートと月間クォータを設定します。

  ティア	リクエスト／分	月間クォータ
  free	10	1,000
  pro	120	100,000
  ultra	600	2,000,000

• 上限を超えると、明確な ToolError（Rate limit exceeded…／Monthly quota exceeded…）が返されます。クラッシュすることはありません。

キーの設定（どちらか一方の方法を使用します。ファイルの設定が優先されます）。

# inline
export CRYPTO_MCP_API_KEYS="sk_live_abc:acme:pro,sk_live_xyz:jane:free"
# or a file (see api_keys.example.json)
export CRYPTO_MCP_API_KEYS_FILE=./api_keys.json

HTTP モードでキーが設定されていない場合、使い捨ての**デモキー（tier=pro）**が生成され、すぐにテストできるよう stderr に出力されます。

ゲートウェイの背後に配置する場合（例：MCPize）

サブスクライバーの認証とレート制限をすでに行うプラットフォームの背後に配置する場合は、CRYPTO_MCP_DISABLE_AUTH=1 を設定してください。サーバーはゲートウェイを信頼し、独自の認証とレート制限をスキップします。認証やスロットリングが二重に行われることはありません。コンテナにアクセスできるのがそのゲートウェイ経由のみの場合に限り、この設定を使用してください。

Claude Desktop で使用する

claude_desktop_config.example.json を Claude Desktop の設定ファイル（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json）にコピーし、パスを調整してください。

シンボル

• 現物：BTC/USDT
• 無期限：BTC/USDT:USDT
• 一般的な略記は自動的に正規化されます。btc、BTCUSDT、BTC-USDT はすべて使用できます（ファンディング／OI ツールでは無期限契約の形式に変換されます）。

---

ロードマップ

• SUPPORTED_EXCHANGES に取引所を追加します。
• レイテンシを抑えるため、利用頻度の高いシンボルのキャッシュをさらに強化します。
• ライブのオーダーブック／取引情報向けに、オプションの WebSocket ストリーミングを追加します。