CCXT Cryptocurrency Exchange

🚀 加密货币市场数据 MCP 服务器

本项目是一个模型上下文协议（MCP）服务器，通过集成主要交易所，为 Claude 等大语言模型提供实时和历史加密货币市场数据。大语言模型可借助该服务器获取当前价格、分析市场趋势并访问详细的交易信息。

🚀 快速开始

1. 安装依赖

   pip install ccxt python-dotenv
   

2. 配置环境变量 创建一个 .env 文件并添加以下内容：

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

3. 运行服务器

   python -m crypto_mcp_server.main
   

✨ 主要特性

• 实时市场数据
  • 提供当前加密货币价格。
  • 展示市场概览（包括买卖价差）。
  • 列出交易量排名靠前的交易对。
  • 支持多个交易所。
• 历史分析
  • 提供 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 .

💻 使用示例

示例查询

基础用法

# 获取当前价格
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 文件。

致谢

• CCXT 提供交易所接口集成。
• Model Context Protocol 定义 MCP 规范。
• 各个加密货币交易所提供市场数据 API。