CCXT MCP Server

CCXT MCP サーバー

CCXT ライブラリを通じて取引機能を提供する Model Context Protocol（MCP）サーバーです。

機能

• 任意のシンボルのティッカーデータを取得
• 板情報を取得
• 最近の取引を表示
• 注文を作成（成行、指値など）
• 注文をキャンセル
• 口座残高を取得
• 取引分析プロンプト
• 注文管理のガイダンス
• テストネットに対応
• CCXT がサポートするすべての取引所に対応
• パフォーマンス向上のため、取引所インスタンスをキャッシュ

プロジェクト構成

src/ccxt_mcp/
├── __init__.py              # Main server file
├── utils/
│   └── exchange.py          # Exchange management with testnet support
├── tools/
│   ├── fetch_ticker.py      # Ticker data tool
│   ├── fetch_order_book.py  # Order book tool
│   ├── fetch_trades.py      # Trades tool
│   ├── create_order.py      # Order creation tool
│   ├── cancel_order.py      # Order cancellation tool
│   └── fetch_balance.py     # Balance fetching tool
└── prompts/
    ├── trading_analysis.py  # Trading analysis prompt
    ├── order_management.py  # Order management prompt
    └── testnet_guidance.py  # Testnet guidance prompt

MCP サーバーのセットアップ

前提条件：

以下は Claude Desktop 向けの手順ですが、この MCP サーバーはあらゆる MCP クライアントで使用できます。

1. GitHub リポジトリをダウンロードします：

git clone https://github.com/pcriadoperez/ccxt-mcp.git

2. フォルダーに移動します cd ccxt-mcp

3. MCP サーバーをインストールします mcp install run.py

4. Claude Desktop を開き、「Settings」→「Developer」→「Edit config」の順に選択します

• 環境変数を追加します
• コマンド内の uv の場所を置き換える必要がある場合があります（which uv を実行すると確認できます）
• 設定は以下のようになります

{
  "mcpServers": {
    "CCXT Trading Server": {
      "command": "/Users/pablo/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "ccxt",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/Users/pablo/github/ccxt-mcp-2/run.py"
      ],
      "env":{
          "BINANCE_APIKEY": "BINANCE_APIKEY",
          "BINANCE_SECRET": "BINANCE_SECRET"
      }
    }
  }
}

5. Claude を終了して、再度開きます

貢献するためのセットアップ

1. リポジトリをクローンします：

git clone https://github.com/pcriadoperez/ccxt-mcp.git
cd ccxt-mcp

2. 依存関係をインストールします：

uv pip install -e .

3. 環境変数を設定します：

# Copy the example environment file
cp .env.example .env

# Edit .env with your API keys
# Add your exchange API keys in the format:
# {EXCHANGE_ID}_API_KEY=your_api_key
# {EXCHANGE_ID}_SECRET=your_secret

開発時の使用方法

1. 開発用 MCP サーバーを起動します：

mcp dev run.py

セキュリティ

• .env ファイルをコミットしないでください
• API キーには環境変数を使用してください
• 本番環境ではシークレット管理サービスの使用を検討してください
• 開発およびテストにはテストネットを推奨します

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. プルリクエストを作成します

ライセンス

MIT