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 を自動的にインストールするには:

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

構成

環境ファイルを作成する
cp .env.example .env
.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 通信で問題が発生した場合は、トラブルシューティングガイドで解決策を確認してください。

サーバーの実行

サーバーを起動します。

# If installed globally via npm
mcp-server-ccxt

# If installed manually
npm start

Claude for Desktop と併用

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

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

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

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

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

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

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

このパッケージを独自の 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の注文帳を見せてください」
「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 には、高いパフォーマンスを確保するためのいくつかの最適化が含まれています。

LRUキャッシュシステム:
- データの種類ごとに異なるTTL
- ティッカーデータ: 10秒
- 注文簿データ: 5秒
- 市場データ: 1時間
適応型レート制限:
- 交換応答に基づいてリクエストレートを自動的に調整します
- エラーに対する指数バックオフを実装する
- 交換ごとに同時リクエストを管理します
Exchange接続管理:
- 交換インスタンスの効率的な初期化
- 適切なエラー処理と再試行

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

APIキーのセキュリティ

専用APIキーを作成する:
- 異なるアプリケーション/目的ごとに個別のAPIキーを作成する
- 異なるサービスやアプリケーション間で API キーを再利用しないでください
APIキーの権限を制限する:
- 必要な権限のみを有効にする（例：市場データは読み取り専用）
- 取引機能のみが必要な場合は出金権限を無効にします
- 既知のIPへのアクセスを制限するために、IPホワイトリストが利用可能な場合は使用する
安全な保管:
- APIキーをバージョン管理システムにコミットしないでください
- APIキーを環境変数または安全な保管庫に保存する
- .gitignoreで git から除外されている.envファイルを使用する

リスク免責事項

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

金融リスク：暗号通貨取引には損失のリスクが伴う
APIセキュリティ: APIキーに適切な権限制限があることを確認する
投資アドバイスなし：このツールは投資アドバイスを提供しません
無保証: ソフトウェアはいかなる保証もなく「現状のまま」提供されます

ライセンス

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

著作権と帰属

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

Copyright (c) 2016-2024 CCXT developers

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

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 リポジトリにアクセスしてください。

CCXT MCP Server

Integrations