CCXT Cryptocurrency Exchange

🚀 加密貨幣市場數據 MCP 服務器

本服務器基於模型上下文協議（MCP），集成各大主流交易所，為Claude等大語言模型提供即時與歷史加密貨幣市場數據。大語言模型藉助該服務器，可獲取當前價格、分析市場趨勢並訪問詳細交易信息。

✨ 主要特性

• 即時市場數據

  • 提供當前加密貨幣價格。
  • 呈現市場概覽，包含買賣價差。
  • 展示交易量排名靠前的交易對。
  • 支持多個主流交易所。

• 歷史分析

  • 提供OHLCV（燭臺）數據。
  • 統計價格變動情況。
  • 跟蹤成交量歷史數據。
  • 支持自定義時間範圍查詢。

• 支持的交易所

  • Binance（幣安）
  • Coinbase（Coinbase）
  • Kraken（Kraken）
  • KuCoin（KuCoin）
  • HyperLiquid
  • Huobi（火幣）
  • Bitfinex（Bitfinex）
  • Bybit（Bybit）
  • OKX（OKX）
  • BitMax（BitMax）

📦 安裝指南

使用 pip 安裝

pip install crypto-mcp-server

包依賴

pip install ccxt python-dotenv requests

克隆倉庫

git clone [repository-url]
cd crypto-mcp-server
uv pip install -e .

🚀 快速開始

1. 安裝依賴

   pip install ccxt python-dotenv
   

2. 配置環境變量 創建一個 .env 文件並添加以下內容：

   CCXT_API_KEY=你的API密鑰
   CCXT_SECRET_KEY=你的API秘密密鑰
   

3. 運行服務器

   python -m crypto_mcp_server.main
   

💻 使用示例

示例查詢

基礎用法

獲取當前價格

curl http://localhost:8000/price/BTCUSDT

高級用法

獲取歷史數據

curl http://localhost:8000/historical_data/BTCUSDT/1D

示例輸出

當前價格響應

{
  "price": 45000.5,
  "timestamp": "2023-10-26T12:00:00Z"
}

歷史數據響應

[
  {
    "open": 44800.0,
    "close": 45200.5,
    "high": 45300.0,
    "low": 44700.5,
    "volume": 123456789
  },
  ...
]

📚 詳細文檔

功能模塊

價格獲取

• 支持多種時間範圍（1小時、1天、1周等）。
• 返回當前價格和最近更新時間。

歷史數據

• 提供過去24小時的交易記錄。
• 包括開盤價、收盤價、最高價、最低價和成交額。

交易所信息

• 顯示指定交易所的基本信息，如成立時間、總部位置等。

🔧 技術細節

實現方式

• 使用 CCXT 庫進行交易所接口調用。
• 遵循 MCP 協議規範。
• 支持可擴展插件架構。

錯誤處理

• 網絡連接錯誤自動重試（最多3次）。
• 請求超時設置為10秒。
• 詳細日誌記錄便於調試。

📄 許可證

MIT License - 詳見 LICENSE 文件

致謝

• CCXT 提供交易所接口集成。
• Model Context Protocol 定義 MCP 規範。
• 各個加密貨幣交易所提供市場數據 API。