MCP Server Ccxt

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

一個通過整合主要交易所，提供即時和歷史加密貨幣市場數據的 Model Context Protocol (MCP) 服務器。該服務器可讓像 Claude 這樣的大語言模型（LLM）獲取當前價格、分析市場趨勢並訪問詳細的交易信息。

✨ 主要特性

• 即時市場數據

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

• 歷史分析

  • 提供 OHLCV（燭臺）數據。
  • 進行價格波動分析。
  • 分析成交量與時間的關係。
  • 配備數據可視化工具。

• 交易所支持

  • 支持多種主流加密貨幣交易所，如幣安、Coinbase 和火幣等。
  • 提供統一的 API 接口，方便數據獲取。

📦 安裝指南

使用 Smithery 安裝

# 待實施
pytest tests/

手動安裝

1. 克隆倉庫：

   git clone [倉庫地址]
   cd 加密貨幣-mcp-服務器
   

2. 安裝依賴項：

   uv pip install -e .
   

💻 使用示例

運行服務器

# 待實施
pytest tests/

連接 Claude Desktop

1. 拷貝以下代碼到終端：

   uv pip install crypto-mcp-server
   

2. 啟動服務器：

   python3 src/server.py
   

交互方式 - get-price

• 功能：獲取指定加密貨幣的價格信息。
• 示例：

  curl --location 'http://localhost:8080 getPrice' \
       --header 'Content-Type: application/json' \
       --data-raw '{
           "symbol": "BTC/USDT"
       }'
  

🔧 技術細節

依賴項管理

• 使用 pipenv 管理 Python 依賴。
• 項目根目錄包含 Pipfile。
• 需要安裝的包包括：ccxt、flask、requests。

架構設計

1. 服務器端

   • 實現 RESTful API 接口。
   • 使用 Flask 框架搭建服務器。
   • 整合 CCXT 庫進行數據獲取。

2. 客戶端

   • 提供命令行工具，方便用戶操作。
   • 支持圖形化界面（待開發）。
   • 具備可擴展插件系統。

🚧 錯誤處理與故障排除

常見錯誤及解決方案

1. 交易所連接問題

   • 檢查網絡狀態是否正常。
   • 確認交易所在線。
   • 驗證交易對是否存在。

2. 速率限制

   • 在請求之間添加延遲，避免頻繁請求。
   • 使用不同的交易所進行高頻率查詢。
   • 查看具體交易所的限速策略。

常見問題及解決辦法

1. 數據格式錯誤

   • 確保交易對格式正確（如 BTC/USDT，而非 BTCUSDT）。
   • 檢查時間範圍規範。
   • 驗證數值參數在有效範圍內。

2. 連接超時

   • 檢查網絡延遲情況。
   • 切換 API 地址。
   • 增加超時設置。

🛠️ 開發指南

提交代碼

1. 叉取倉庫：

   git clone [repository-url]
   cd crypto-mcp-server
   

2. 創建功能分支：

   git checkout -b feature/新特性名稱
   

3. 進行修改並提交：

   git add .
   git commit -m "添加新功能"
   

4. 提交拉取請求。

📄 許可證

本項目採用 MIT License，詳情請參閱 LICENSE 文件。

🙏 致謝

• 感謝 CCXT 團隊提供的交易所接口。
• 感謝 Model Context Protocol 定義的 MCP 規範。
• 感謝各大加密貨幣交易所提供的市場數據 API。