Ccxt MCP

🚀 CCXT MCP サーバー

CCXTライブラリを通じて取引機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• 任意のシンボルのティッカーデータを取得
• オーダーブックデータを確認
• 最近の取引を確認
• 注文を作成（成行注文、指値注文など）
• 注文を取消
• アカウント残高を取得
• 取引分析のヒントを提供
• 注文管理のガイドを提供
• テストネットをサポート
• CCXTがサポートする任意の取引所をサポート
• キャッシュ付きの取引インスタンスでパフォーマンスを向上

📚 ドキュメント

プロジェクト構造

src/ccxt_mcp/
├── __init__.py              # メインサーバーファイル
├── utils/
│   └── exchange.py          # 取引所管理（テストネットサポート付き）
├── tools/
│   ├── fetch_ticker.py      # ティッカーデータツール
│   ├── fetch_order_book.py  # オーダーブックツール
│   ├── fetch_trades.py      # 取引ツール
│   ├── create_order.py      # 注文作成ツール
│   ├── cancel_order.py      # 注文取消ツール
│   └── fetch_balance.py     # 残高照会ツール
└── prompts/
    ├── trading_analysis.py  # 取引分析ヒント
    ├── order_management.py  # 注文管理ヒント
    └── testnet_guidance.py  # テストネットガイドヒント

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デスクトップを開き -> 設定 -> 開発者 -> 設定を編集

• 環境変数を追加
• コマンド内の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. 環境変数を設定：

# サンプル環境ファイルをコピー
cp .env.example .env

# .envファイルを編集してAPIキーを追加
# 以下の形式で取引所のAPIキーを追加します：
# {EXCHANGE_ID}_API_KEY=your_api_key
# {EXCHANGE_ID}_SECRET=your_api_secret

🔧 技術詳細

セキュリティに関する注意事項

• .envファイルをバージョン管理システムにコミットしないでください。
• 環境変数を使用して機密情報（APIキーなど）を保存してください。
• リスクを減らすために、テストネットで取引操作を行うことをおすすめします。

コントリビューションの流れ

1. このリポジトリをあなたのGitHubアカウントにフォークします。
2. 新しい機能ブランチを作成：git checkout -b feature/your-feature-name
3. 変更をコミット：git commit -m "行った変更を説明するメッセージ"
4. フォークしたリポジトリにプッシュ：git push origin feature/your-feature-name
5. 元のリポジトリにプルリクエストを作成します。