Ccxt MCP

🚀 CCXT MCP 服务器

CCXT MCP 服务器是一个借助 CCXT 库来提供交易功能的模型上下文协议（MCP）服务器，能让用户便捷地进行各类交易操作。

🚀 快速开始

运行 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

✨ 主要特性

• 获取任意符号的 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  # 测试网指导提示

🤝 贡献流程

1. 分叉此仓库到你的 GitHub 账户。
2. 创建新的功能分支：git checkout -b feature/your-feature-name。
3. 提交你的更改：git commit -m "描述你所做的更改"。
4. 推送到分叉的仓库：git push origin feature/your-feature-name。
5. 创建拉取请求到原仓库。

⚠️ 安全注意事项

⚠️ 重要提示

• 不要提交 .env 文件到版本控制系统。
• 使用环境变量存储敏感信息（如 API 密钥）。
• 建议在测试网中进行交易操作以降低风险。