CCXT MCP サーバー

MCP (モデルコンテキストプロトコル) と CCXT を使用した高性能暗号通貨交換統合。

特徴

• 🚀取引所サポート：20以上の暗号通貨取引所に接続

• 🔃市場タイプ：スポット、先物、スワップ市場などをサポート

• 🔧プロキシ設定：プロキシ経由で取引所にアクセスするためのオプション

• 📊高速で信頼性が高い：最適化されたキャッシュとレート制限

• 🌐 MCP 標準: MCP を介して Claude や GPT などの LLM と互換性があります

CCXT MCP サーバー統合アーキテクチャ

CCXT MCPサーバーは、モデルコンテキストプロトコルを介して言語モデルと暗号通貨取引所を接続します。これは、LLMがリアルタイムの市場データにアクセスし、統合APIを介して複数の取引所間で取引操作を実行できるようにするブリッジとして機能します。

アーキテクチャには以下が含まれます。

• リクエストを送信するLLMクライアント（Claudeおよびその他のMCP互換モデル）

• 通信を標準化するモデルコンテキストプロトコル（MCP）

• リクエストを処理し、交換のやり取りを管理するCCXT MCPサーバー

• 取引所APIへの統一されたアクセスを提供するCCXTライブラリ

• 複数の暗号通貨取引所への接続

CCXT MCP サーバーコードアーキテクチャ

サーバーは、保守性と拡張性を向上させるために 3 つの主要モジュールで構成されています。

• Exchange : Exchangeインスタンス、資格情報、シンボル検証を管理します

• ユーティリティ: キャッシュ、レート制限、ログ機能を提供します

• ツール: 交換インタラクションのためのMCPツールとリソースを実装します

クイックスタート

Smithery経由でインストール

Smithery経由で Claude Desktop 用の mcp-server-ccxt を自動的にインストールするには:

NPM パッケージ (推奨)

CCXT MCP サーバーは npm からインストールできます。

または直接実行します:

手動インストール

あるいは、リポジトリをクローンしてビルドすることもできます。

構成

1. 環境ファイルを作成する

   cp .env.example .env

2. .envファイルを編集して、Exchange APIキーを追加します。

   # Default exchange (optional) DEFAULT_EXCHANGE=binance # Default market type (optional) DEFAULT_MARKET_TYPE=spot # API credentials (optional) BINANCE_API_KEY=your_api_key BINANCE_SECRET=your_api_secret # Proxy configuration (optional) USE_PROXY=false PROXY_URL=http://username:password@your-proxy-server:port # Legacy format (still supported but recommended to use the integrated URL format above) # PROXY_USERNAME= # PROXY_PASSWORD=

使用法

注: MCP 通信で問題が発生した場合は、トラブルシューティング ガイドで解決策を確認してください。

サーバーの実行

サーバーを起動します。

Claude for Desktop と併用

1. claude_desktop_config.jsonにサーバーを追加します。

npm 経由でインストールした場合 (グローバル):

手動でインストールする場合:

2. デスクトップ版のClaudeを再起動

別のプロジェクトでモジュールとして使用する

このパッケージを独自の Node.js プロジェクトのモジュールとして使用することもできます。

クエリの例

MCP サーバーで使用できるクエリの例を次に示します。

• 「Binanceでのビットコインの現在の価格はいくらですか？」

• 「CoinbaseのETH/USDTの注文帳を見せてください」

• 「Binanceで過去24本のBTC/USDTの1時間OHLCVデータを取得します」

• 「異なる取引所間でSOL/USDTの価格を比較する」

• 「Binanceの現在の残高はいくらですか？」（APIキーが必要です）

• 「Krakenで0.1 ETHの市場買い注文を出す」（APIキーが必要）

利用可能なツール

パブリックAPIツール

• list-exchanges : 利用可能なすべての暗号通貨取引所を一覧表示します

• get-ticker : 取引ペアの現在のティッカー情報を取得する

• batch-get-tickers : 複数の取引ペアのティッカー情報を一度に取得する

• get-orderbook / get-order-book : 取引ペアの市場注文帳を取得する

• get-ohlcv : 取引ペアのOHLCVローソク足データを取得する

• get-trades : 取引ペアの最近の取引を取得する

• get-markets : 取引所で利用可能なすべての市場を取得する

• get-exchange-info : 取引所の情報とステータスを取得する

• get-leverage-tiers : 先物レバレッジ階層を取得する

• get-funding-rates : 現在の資金調達率を取得する

• get-positions : オープンポジション情報を取得する

• get-open-orders : すべてのオープン注文を取得する

• get-order-history : 注文履歴を取得する

プライベート API ツール (API キーが必要)

• account-balance : 暗号通貨取引所からアカウント残高を取得する

• place-market-order : 取引所で成行注文を出す

• place-limit-order : 取引所で指値注文を出す

• cancel-order : 既存の注文をキャンセルする

• cancel-all-orders : すべてのオープン注文をキャンセルする

• set-leverage : 先物のレバレッジを設定する

• set-margin-mode : 先物のマージンモードを設定する

• place-futures-market-order : 先物市場注文を出す

• place-futures-limit-order : 先物指値注文を出す

• transfer-funds : 口座間の資金移動（例：スポットから先物）

構成とユーティリティツール

• cache-stats : CCXT キャッシュ統計を取得する

• clear-cache : CCXT キャッシュをクリアする

• set-log-level : ログレベルを設定する

• get-proxy-config : プロキシ設定を取得する

• set-proxy-config : プロキシ設定を構成する

• set-market-type : デフォルトのマーケットタイプを設定する

• set-default-exchange : デフォルトの交換を変更する

• system-info : システムと環境の情報を取得する

パフォーマンスの最適化

MCP-CCXT には、高いパフォーマンスを確保するためのいくつかの最適化が含まれています。

1. LRUキャッシュシステム:

   • データの種類ごとに異なるTTL

   • ティッカーデータ: 10秒

   • 注文簿データ: 5秒

   • 市場データ: 1時間

2. 適応型レート制限:

   • 交換応答に基づいてリクエストレートを自動的に調整します

   • エラーに対する指数バックオフを実装する

   • 交換ごとに同時リクエストを管理します

3. Exchange接続管理:

   • 交換インスタンスの効率的な初期化

   • 適切なエラー処理と再試行

セキュリティのベストプラクティス

APIキーのセキュリティ

1. 専用APIキーを作成する:

   • 異なるアプリケーション/目的ごとに個別のAPIキーを作成する

   • 異なるサービスやアプリケーション間で API キーを再利用しないでください

2. APIキーの権限を制限する:

   • 必要な権限のみを有効にする（例：市場データは読み取り専用）

   • 取引機能のみが必要な場合は出金権限を無効にします

   • 既知のIPへのアクセスを制限するために、IPホワイトリストが利用可能な場合は使用する

3. 安全な保管:

   • APIキーをバージョン管理システムにコミットしないでください

   • APIキーを環境変数または安全な保管庫に保存する

   • .gitignoreで git から除外されている.envファイルを使用する

リスク免責事項

このソフトウェアは情報提供のみを目的として提供されています。このソフトウェアを使用して暗号通貨取引所とやり取りすると、重大なリスクを伴います。

• 金融リスク：暗号通貨取引には損失のリスクが伴う

• APIセキュリティ: APIキーに適切な権限制限があることを確認する

• 投資アドバイスなし：このツールは投資アドバイスを提供しません

• 無保証: ソフトウェアはいかなる保証もなく「現状のまま」提供されます

ライセンス

このプロジェクト��� MIT ライセンスに基づいてライセンスされています。詳細については、 LICENSE.txtファイルを参照してください。

著作権と帰属

このプロジェクトでは、次の CCXT ライブラリ ( https://github.com/ccxt/ccxt ) を使用します。

CCXT は、以下に記載されている MIT ライセンスの下でリリースされています。

問題、機能のリクエスト、または貢献については、 GitHub リポジトリにアクセスしてください。