Nayshins_mcp-server-ccxt

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

本加密货币市场数据 MCP 服务器通过与主要交易所集成，提供实时和历史加密货币市场数据。它让像 Claude 这样的大型语言模型能获取当前价格、分析市场趋势并访问详细交易信息。

🚀 快速开始

本 MCP 服务器可助力大型语言模型获取加密货币市场数据。你可以按照以下步骤进行安装和使用。

✨ 主要特性

• 实时市场数据
  • 提供当前加密货币价格。
  • 给出市场摘要，包含买卖价差。
  • 呈现交易量最大的顶级交易对。
  • 支持多个主流交易所。
• 历史分析
  • 提供 OHLCV（烛台）数据。
  • 进行价格变化统计。
  • 跟踪交易量历史。
  • 支持可自定义的时间段。
• 交易所支持：支持 Binance、Coinbase、Kraken、KuCoin、HyperLiquid、Huobi、Bitfinex、Bybit、OKX、MEXC 等众多交易所。

📦 安装指南

# 使用 uv（推荐）
uv pip install mcp ccxt

# 使用 pip
pip install mcp ccxt

💻 使用示例

运行服务器

python crypto_server.py

与Claude Desktop连接

1. 打开你的Claude Desktop配置文件：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. 添加服务器配置：

{
  "servers": {
    "crypto-mcp-server": {
      "type": "mcp",
      "uri": "http://localhost:5000"
    }
  }
}

3. 重启Claude Desktop以应用更改。

基础用法

实时价格查询

>>> from crypto_mcp_server import MarketData
>>> client = MarketData()
>>> print(client.get_current_price("BTC/USDT"))
45000.25

历史数据获取

>>> print(client.get_historical_data("ETH/USDT", "1D"))
[
    [1625932800, 2700.0, 2720.0, 2680.0, 2710.0, 456.25],
    ...
]

🔧 技术细节

• 本服务器使用 Python 编写。
• 基于 MCP 协议实现。
• 集成了 CCXT 库进行交易所数据交互。
• 支持多线程处理高并发请求。

📚 详细文档

问题排查

常见问题

1. 交易所连接错误
   • 检查互联网连接。
   • 确认交易所状态正常。
   • 验证交易对在选定的交易所中存在。
2. 速率限制
   • 在请求之间添加延迟。
   • 使用不同的交易所处理高频查询。
   • 检查各个交易所的特定速率限制。
3. 数据格式问题
   • 确认交易对格式正确（例如：BTC/USDT，而不是 BTCUSDT）。
   • 检查时间段规范。
   • 确保数值参数在有效范围内。

📄 许可证

本项目采用 MIT License 许可协议 - 请参阅 LICENSE 文件以获取详细信息。

🙏 致谢

• CCXT 提供交易所集成。
• 模型上下文协议 提供 MCP 规范。
• 各个加密货币交易所提供市场数据 API。