CCXT MCP Server

CCXT MCP サーバー

MCP（Model Context Protocol）と CCXT を使用した、高性能な暗号資産取引所連携機能です。

特長

• 🚀 取引所のサポート：20 以上の暗号資産取引所に接続します
• 🔃 マーケットタイプ：現物、先物、スワップ市場などをサポートします
• 🔧 プロキシ設定：プロキシ経由で取引所にアクセスするオプションを利用できます
• 📊 高速かつ高信頼：キャッシュとレート制限を最適化しています
• 🌐 MCP 標準：MCP 経由で Claude や GPT などの LLM と互換性があります

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

CCXT MCP サーバーは、Model Context Protocol を介して言語モデルを暗号資産取引所に接続します。複数の取引所にまたがるリアルタイムの市場データへのアクセスや取引操作の実行を、統一された API 経由で LLM に可能にする橋渡し役として機能します。

アーキテクチャは以下で構成されています：

• リクエストを送信する LLM クライアント（Claude およびその他の MCP 互換モデル）
• 通信を標準化する Model Context Protocol（MCP）
• リクエストを処理し、取引所とのやり取りを管理する CCXT MCP サーバー
• 取引所 API への統一されたアクセスを提供する CCXT ライブラリ
• 複数の暗号資産取引所への接続

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

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

• Exchange：取引所インスタンス、認証情報、シンボルの検証を管理します
• Utils：キャッシュ、レート制限、ログ機能を提供します
• Tools：取引所とのやり取りに使う MCP ツールとリソースを実装します

クイックスタート

Smithery 経由でインストールする

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

npx -y @smithery/cli install @doggybee/mcp-server-ccxt --client claude

NPM パッケージ（推奨）

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

# Install globally
npm install -g @mcpfun/mcp-server-ccxt

# Start the server
mcp-server-ccxt

または、直接実行します：

npx @mcpfun/mcp-server-ccxt

手動インストール

リポジトリをクローンしてビルドすることもできます：

# Clone the repository
git clone https://github.com/doggybee/mcp-server-ccxt.git
cd mcp-server-ccxt

# Install dependencies
npm install

# Build the server
npm run build

# Start the server
npm start

設定

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

   cp .env.example .env
   

2. .env ファイルを編集して、取引所の 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
   # For exchanges requiring passphrase (e.g., KuCoin)
   KUCOIN_API_KEY=your_kucoin_api_key
   KUCOIN_SECRET=your_kucoin_secret
   KUCOIN_PASSPHRASE=your_kucoin_passphrase
   
   # 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 通信で問題が発生した場合は、解決方法についてトラブルシューティングガイドを参照してください。

サーバーを実行する

サーバーを起動します：

# If installed globally via npm
mcp-server-ccxt

# If installed manually
npm start

Claude for Desktop で使用する

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

npm でインストールした場合（グローバル）：

{
  "mcpServers": {
    "ccxt": {
      "command": "mcp-server-ccxt"
    }
  }
}

手動でインストールした場合：

{
  "mcpServers": {
    "ccxt": {
      "command": "node",
      "args": [
        "/path/to/mcp-server-ccxt/build/index.js"
      ]
    }
  }
}

2. Claude for Desktop を再起動します

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

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

// Import the CCXT MCP Server
import '@mcpfun/mcp-server-ccxt';

// The server starts automatically when imported
// You can configure it through environment variables

クエリの例

MCP サーバーで使用できるクエリの例を紹介します：

• 「Binance の現在のビットコイン価格は？」
• 「Coinbase の ETH/USDT のオーダーブックを表示して」
• 「過去 24 本分の、Binance における BTC/USDT の 1 時間足 OHLCV データを取得して」
• 「複数の取引所で SOL/USDT の価格を比較して」
• 「Binance の現在の残高は？」（API キーが必要です）
• 「Kraken で ETH を 0.1 枚、成行買い注文して」（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. 取引所接続の管理：

   • 取引所インスタンスを効率的に初期化します
   • 適切なエラー処理と再試行を行います

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

API キーのセキュリティ

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

   • アプリケーションや用途ごとに個別の API キーを作成します
   • 異なるサービスやアプリケーション間で API キーを使い回さないでください

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

   • 必要な権限のみを有効にします（例：市場データ用の読み取り専用権限）
   • 取引機能のみが必要な場合は、出金権限を無効にします
   • 利用可能な場合は IP ホワイトリストを使用して、既知の IP からのアクセスに制限します

3. 安全な保管：

   • API キーをバージョン管理システムにコミットしないでください
   • API キーは環境変数または安全な保管庫に保存します
   • .gitignore を使って Git の対象から除外した .env ファイルを使用します

リスクに関する免責事項

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

• 金銭的リスク：暗号資産の取引には損失のリスクが伴います
• API セキュリティ：API キーに適切な権限制限が設定されていることを確認してください
• 投資助言ではありません：このツールは投資助言を提供しません
• 保証なし：このソフトウェアは、いかなる種類の保証もなく「現状有姿」で提供されます

ライセンス

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

著作権と帰属表示

このプロジェクトは CCXT ライブラリ（https://github.com/ccxt/ccxt）を使用しています。CCXT は次のとおりです。

Copyright (c) 2016-2024 CCXT developers

CCXT は MIT License の下で公開されており、以下にライセンスを記載しています。

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---

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