加密货币市场数据 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