CCXT MCP 服务器

一个通过CCXT库提供交易功能的模型上下文协议（MCP）服务器。

功能

• 获取任意符号的Ticker数据
• 查看订单簿数据
• 查看最近交易
• 创建订单（市价单、限价单等）
• 撤销订单
• 获取账户余额
• 交易分析提示
• 订单管理指导
• 测试网支持
• 支持CCXT支持的任何交易所
• 带缓存的交换实例以提高性能

项目结构

src/ccxt_mcp/
├── __init__.py              # 主服务器文件
├── utils/
│   └── exchange.py          # 交易所管理（带测试网支持）
├── tools/
│   ├── fetch_ticker.py      # Ticker数据工具
│   ├── 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

# 使用你的API密钥编辑.env文件
# 以格式添加你的交易所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. 创建拉取请求到原仓库