Mcp Server Ccxt

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

加密货币市场数据 MCP 服务器借助整合主要交易所的数据，提供实时和历史的加密货币市场数据。它基于 Model Context Protocol (MCP)，能让像 Claude 这样的大语言模型获取当前价格、分析市场趋势以及访问详细的交易信息。

🚀 快速开始

本服务器可通过 Smithery 或手动方式进行安装，以下将详细介绍安装和使用步骤。

✨ 主要特性

• 实时市场数据
  • 提供当前加密货币价格。
  • 呈现市场摘要，涵盖买卖价差。
  • 展示交易量排名靠前的交易对。
  • 支持多个主流加密货币交易所。
• 历史分析
  • 提供 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。