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

一个模型上下文协议 (MCP) 服务器，通过与主要交易所的集成，提供实时和历史加密货币市场数据。该服务器使像 Claude 这样的大型语言模型 (LLM) 能够获取当前价格、分析市场趋势并访问详细的交易信息。

<a href="https://glama.ai/mcp/servers/9kbbk1kmg2"><img width="380" height="200" src="https://glama.ai/mcp/servers/9kbbk1kmg2/badge" alt="Cryptocurrency Market Data Server MCP server" /></a>

特性

• 实时市场数据

  • 当前加密货币价格
  • 包含买/卖价差的市场摘要
  • 按交易量排名的热门交易对
  • 多交易所支持

• 历史分析

  • OHLCV（K线图）数据
  • 价格变动统计
  • 交易量历史跟踪
  • 可自定义的时间范围

• 交易所支持

  • 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. 添加服务器配置：

{
    "mcpServers": {
        "crypto": {
            "command": "python",
            "args": ["/path/to/crypto_server.py"]
        }
    }
}

3. 重启 Claude Desktop

可用工具

1. get-price

   • 获取任何交易对的当前价格
   • 示例: "币安上 BTC/USDT 的当前价格是多少？"

2. get-market-summary

   • 获取详细的市场信息
   • 示例: "显示 ETH/USDT 的市场摘要"

3. get-top-volumes

   • 列出按交易量排名的热门交易对
   • 示例: "Kraken 上交易量排名前 5 的交易对是什么？"

4. list-exchanges

   • 显示所有支持的交易所
   • 示例: "支持哪些交易所？"

5. get-historical-ohlcv

   • 获取历史 K 线图数据
   • 示例: "显示过去 7 天 BTC/USDT 的 1 小时间隔价格数据"

6. get-price-change

   • 计算不同时间范围内的价格变化
   • 示例: "SOL/USDT 的 24 小时价格变化是多少？"

7. get-volume-history

   • 跟踪一段时间内的交易量
   • 示例: "显示过去一周 ETH/USDT 的交易量历史"

示例查询

以下是一些您可以连接服务器后向 Claude 提出的示例问题：

- 币安上比特币的当前价格是多少？
- 显示 Coinbase 上交易量排名前 5 的交易对
- 过去 24 小时 ETH/USDT 的表现如何？
- 给我一份 Kraken 上 SOL/USDT 的详细市场摘要
- 过去一周 BNB/USDT 的交易量历史是多少？

技术细节

依赖项

• mcp: 模型上下文协议 SDK
• ccxt: 加密货币交易所交易库
• Python 3.9 或更高版本

架构

该服务器使用：

• CCXT 的异步支持，用于高效的交易所通信
• MCP 的工具系统，用于 LLM 集成
• 标准化的数据格式，用于一致的输出
• 连接池，用于最佳性能

错误处理

该服务器实现了强大的错误处理，用于：

• 无效的交易对
• 交易所连接问题
• 速率限制
• 格式错误的请求
• 网络超时

开发

运行测试

# 待实现
pytest tests/

贡献

1. Fork 仓库
2. 创建一个特性分支
3. 进行更改
4. 提交 Pull Request

本地开发

# 克隆仓库
git clone [repository-url]
cd crypto-mcp-server

# 安装依赖
uv pip install -e .

故障排除

常见问题

1. 交易所连接错误

   • 检查您的互联网连接
   • 验证交易所是否正常运行
   • 确保所选交易所存在该交易对

2. 速率限制

   • 在请求之间实施延迟
   • 使用不同的交易所进行高频查询
   • 检查交易所特定的速率限制

3. 数据格式问题

   • 验证交易对格式（例如，BTC/USDT，而不是 BTCUSDT）
   • 检查时间范围规范
   • 确保数值参数在有效范围内

许可证

MIT 许可证 - 有关详细信息，请参见 LICENSE 文件

致谢

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