io.github.lucyfox199818-collab/ccxt-mcp

Official

by lucyfox199818-collab · TypeScript

Codex CCXT MCP

Dry-run-first CCXT MCP with market, account, derivatives, and guarded trading tools.

CCXT integration with dry-run-first approach for market, account, and derivatives trading.

Install

Configuration

Environment variables

BINANCE_API_KEYsecret

Optional Binance API key for private account data and explicitly enabled trading.

BINANCE_API_SECRETsecret

Optional Binance API secret.

CCXT_EXCHANGE_IDdefault binance

CCXT exchange identifier.

CCXT_DEFAULT_TYPEdefault future

Default CCXT market type.

CCXT_SANDBOXdefault false

Use the exchange sandbox when supported.

CCXT_ENABLE_TRADINGdefault false

Explicit live-trading permission gate. Keep false for read-only and dry-run use.

CCXT_DRY_RUNdefault true

Return simulated results for mutating tools instead of sending exchange actions.

claude_desktop_config.json

{
  "mcpServers": {
    "ccxt-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/lucyfox199818-collab/ccxt-mcp:0.1.0"
      ],
      "env": {
        "BINANCE_API_KEY": "<YOUR_BINANCE_API_KEY>",
        "BINANCE_API_SECRET": "<YOUR_BINANCE_API_SECRET>",
        "CCXT_EXCHANGE_ID": "binance",
        "CCXT_DEFAULT_TYPE": "future",
        "CCXT_SANDBOX": "false",
        "CCXT_ENABLE_TRADING": "false",
        "CCXT_DRY_RUN": "true"
      }
    }
  }
}