CCXT MCP Server

CCXT MCP 服务

一个通过 CCXT 库提供交易功能的模型上下文协议（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

• 添加环境变量
• 你可能需要在 command 中将其替换为 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. Fork 此仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

许可证

MIT