crypto_exchange_mcp

Crypto Exchange MCP サーバー

Bybit、Binance、OKXをサポートする、暗号資産取引所向けの包括的な MCP（Model Context Protocol）サーバー実装です。このパッケージは、パブリック API（市場データ）とプライベート API（取引、アカウント管理）の両方を操作するための統一インターフェースを提供します。

機能

パブリック API（認証不要）

• リアルタイム価格データ - 現在のティッカー情報を取得します
• オーダーブックへのアクセス - 現物市場と先物市場のオーダーブックの深さを取得します
• Kライン／ローソク足データ - さまざまな時間間隔の過去の OHLCV データを取得します
• 資金調達率のモニタリング - 無期限契約の資金調達率を追跡します
• 建玉の追跡 - 契約の建玉をモニタリングします（Bybit）
• 取引ペア情報 - 利用可能なシンボルを照会します

プライベート API（認証が必要）

• アカウント残高 - 複数の資産にわたるウォレット残高を照会します
• ポジション管理 - 保有中のポジションと未実現 PnL を表示します
• 注文発注 - 成行注文と指値注文を発注します
• 注文キャンセル - 個別の注文またはすべての注文をキャンセルします
• 注文履歴 - 過去の注文と約定を取得します
• 未約定注文 - 保留中の注文を表示します

対応取引所

取引所	現物	先物	パブリック API	プライベート API
Bybit	✅	✅	✅	✅
Binance	✅	✅	✅	✅
OKX	✅	✅	✅	✅

インストール

GitHub リリースから

uv tool install https://github.com/sydowma/crypto_exchange_mcp/releases/download/v0.3.1/crypto_exchange_mcp_python-0.3.1-py3-none-any.whl

uv を使用（推奨）

cd crypto_exchange_mcp/crypto_exchange_mcp_python
uv sync

pip を使用

cd crypto_exchange_mcp/crypto_exchange_mcp_python
pip install -r requirements.txt

設定

パブリック API のみを使用する場合

設定は不要です。パブリック市場データのエンドポイントは、そのまま利用できます。

プライベート API を使用する場合

API 認証情報を環境変数に設定します。

# Bybit
export BYBIT_API_KEY="your_bybit_api_key"
export BYBIT_API_SECRET="your_bybit_api_secret"

# Binance
export BINANCE_API_KEY="your_binance_api_key"
export BINANCE_API_SECRET="your_binance_api_secret"

# OKX
export OKX_API_KEY="your_okx_api_key"
export OKX_API_SECRET="your_okx_api_secret"
export OKX_PASSPHRASE="your_okx_passphrase"

または、.env.example を .env にコピーして、認証情報を入力します。

cp .env.example .env

Claude Desktop での使用方法

統合サーバー（推奨）

~/Library/Application Support/Claude/claude_desktop_config.json（macOS） または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "crypto-exchange": {
      "command": "uv",
      "args": [
        "--directory",
        "{your_path}/crypto_exchange_mcp/crypto_exchange_mcp_python",
        "run",
        "crypto_exchange_server.py"
      ],
      "env": {
        "BYBIT_API_KEY": "your_bybit_api_key",
        "BYBIT_API_SECRET": "your_bybit_api_secret",
        "BINANCE_API_KEY": "your_binance_api_key",
        "BINANCE_API_SECRET": "your_binance_api_secret",
        "OKX_API_KEY": "your_okx_api_key",
        "OKX_API_SECRET": "your_okx_api_secret",
        "OKX_PASSPHRASE": "your_okx_passphrase"
      }
    }
  }
}

取引所ごとの個別サーバー

各取引所を個別に実行することもできます。

{
  "mcpServers": {
    "bybit": {
      "command": "uv",
      "args": [
        "--directory",
        "{your_path}/crypto_exchange_mcp/crypto_exchange_mcp_python",
        "run",
        "bybit.py"
      ]
    },
    "binance": {
      "command": "uv",
      "args": [
        "--directory",
        "{your_path}/crypto_exchange_mcp/crypto_exchange_mcp_python",
        "run",
        "binance.py"
      ]
    },
    "okx": {
      "command": "uv",
      "args": [
        "--directory",
        "{your_path}/crypto_exchange_mcp/crypto_exchange_mcp_python",
        "run",
        "okx.py"
      ]
    }
  }
}

利用可能なツール

パブリック市場データ

• get_ticker(exchange, symbol) - 価格と過去 24 時間の統計を取得します
• get_orderbook(exchange, symbol, limit) - オーダーブックの深さを取得します
• get_klines(exchange, symbol, interval, limit) - ローソク足データを取得します
• get_symbols(exchange, spot, futures) - 取引ペアを一覧表示します
• get_funding_rate(exchange, symbol) - 無期限契約の資金調達率を取得します
• get_open_interest(exchange, symbol) - 契約の建玉を取得します
• get_new_coins_okx(limit) - OKX に新規上場したコインを取得します

プライベート取引とアカウント

• get_balance(exchange) - アカウント残高を取得します
• get_positions(exchange) - 保有中のポジションを取得します
• place_order(exchange, symbol, side, order_type, quantity, price) - 注文を発注します
• cancel_order(exchange, symbol, order_id) - 注文をキャンセルします
• get_open_orders(exchange, symbol) - 保留中の注文を取得します
• get_order_history(exchange, symbol, limit) - 注文履歴を取得します

ユーティリティ

• get_supported_exchanges() - 取引所と認証状態を一覧表示します
• get_external_mcp_servers() - 設定済みの既製の外部 MCP サーバーを一覧表示します
• list_exchange_mcp_tools(exchange) - 外部取引所 MCP サーバーのツールを一覧表示します
• call_exchange_mcp_tool(exchange, tool_name, arguments) - 外部取引所 MCP サーバーが公開するツールを呼び出します

外部 MCP の集約

統合サーバーは、既存の取引所 MCP 実装を stdio 子サーバーとして起動し、単一のエントリーポイントから公開できます。

デフォルトの外部サーバー：

取引所	外部 MCP	デフォルトのコマンド
Bybit	Bybit 公式トレーディング MCP	npx -y bybit-official-trading-server@latest
OKX	OKX 公式エージェント取引キット	npx -y @okx_ai/okx-trade-mcp@latest --modules market --read-only
Binance	コミュニティ版 Binance MCP サーバー	uvx --from binance-mcp-server binance-mcp-server

メインの crypto-exchange MCP サーバーから、次のツールを使用します。

1. get_external_mcp_servers() で設定済みの子サーバーを確認します。
2. list_exchange_mcp_tools("bybit") または別の取引所を指定して、子サーバーのツールを確認します。
3. call_exchange_mcp_tool("bybit", "tool_name", {"arg": "value"}) で子サーバーのツールを呼び出します。

CRYPTO_EXCHANGE_MCP_CONFIG を使用して、子 MCP サーバーを上書きまたは追加します。

{
  "servers": {
    "okx": {
      "command": "npx",
      "args": [
        "-y",
        "@okx_ai/okx-trade-mcp@latest",
        "--modules",
        "market,spot,account",
        "--read-only"
      ],
      "env_keys": ["OKX_API_KEY", "OKX_API_SECRET", "OKX_PASSPHRASE"]
    }
  }
}

組み込みの外部 MCP 定義を無効にし、設定ファイルのみを使用するには、CRYPTO_EXCHANGE_MCP_ENABLE_DEFAULTS=false を設定します。

取引所ごとのシンボル形式

取引所	現物形式	先物形式
Bybit	BTCUSDT	BTCUSDT
Binance	BTCUSDT	BTCUSDT
OKX	BTC-USDT	BTC-USDT-SWAP

注： OKX の現物取引では実際には -USD の接尾辞（例：BTC-USD）を使用しますが、ティッカーの照会には -USDT も使用できます。

アーキテクチャ

crypto_exchange_mcp_python/
├── core/                      # Core abstractions
│   ├── __init__.py
│   ├── base.py               # Base exchange class and data models
│   ├── config.py             # Configuration and credential management
│   └── exceptions.py         # Custom exceptions
├── exchanges/                 # Exchange implementations
│   ├── bybit/
│   │   └── client.py         # Bybit API client
│   ├── binance/
│   │   └── client.py         # Binance API client
│   └── okx/
│       └── client.py         # OKX API client
├── bybit.py                  # Legacy Bybit MCP server
├── okx.py                    # Legacy OKX MCP server
├── crypto_exchange_server.py # Unified MCP server
└── .env.example              # Example configuration

API ドキュメント

• Bybit API
• Binance API
• OKX API

ライセンス

Apache License 2.0