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 密鑰）。
• 建議在測試網中進行交易操作以降低風險。