加密货币市场数据服务器

一个提供实时和历史加密货币市场数据的MCP服务器,通过与主要交易所集成,使LLMs能够获取当前价格、分析市场趋势和访问详细的交易信息。

  • by guru0613
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 guru0613/mcp-server-ccxt

使用说明

mcp服务器ccxt

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

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

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

特性

  • 实时市场数据

    • 当前加密货币价格
    • 带买卖价差的市场摘要
    • 按交易量排名的顶级交易对
    • 多交换支持
  • 历史分析

    • OHLCV(烛台)数据
    • 价格变动统计
    • 卷历史跟踪
    • 可定制的时间框架
  • Exchange支持

    • 币安
    • Coinbase
    • 海妖
    • KuCoin
    • 超液体
    • 火币
    • Bitfinex
    • Bybit
    • 欧易
    • 墨西哥

安装

通过Smithery安装

通过以下方式自动为Claude Desktop安装加密货币市场数据服务器 铁匠铺:

npx -y @smithery/cli install mcp-server-ccxt --client claude

手动安装

# Using uv (recommended)
uv pip install mcp ccxt

# Using pip
pip install mcp ccxt

用法

运行服务器

python crypto_server.py

与Claude Desktop连接

  1. 在以下位置打开您的Claude Desktop配置:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  2. 添加服务器配置:

{
    "mcpServers": {
        "crypto": {
            "command": "python",
            "args": ["/path/to/crypto_server.py"]
        }
    }
}
  1. 重新启动克劳德桌面

可用工具

  1. 获取价格

    • 获取任何交易对的当前价格
    • 示例:“币安上BTC/USDT的当前价格是多少?”
  2. 获取市场摘要

    • 获取详细的市场信息
    • 示例:“显示ETH/USDT的市场摘要”
  3. 获得最高销量

    • 按交易量列出顶级交易对
    • 示例:“Kraken上排名前五的交易对是什么?”
  4. 列表交换

    • 显示所有支持的交易所
    • 示例:“支持哪些交易所?”
  5. 获取历史ohlcv

    • 获取历史烛台数据
    • 示例:“以1小时为间隔显示BTC/USDT过去7天的价格数据”
  6. 获取价格变动

    • 计算不同时间范围内的价格变化
    • 示例:“SOL/USDT的24小时价格变化是多少?”
  7. 获取卷历史记录

    • 跟踪交易量随时间的变化
    • 示例:“显示上周ETH/USDT的交易量历史记录”

查询示例

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

- What's the current Bitcoin price on Binance?
- Show me the top 5 trading pairs by volume on Coinbase
- How has ETH/USDT performed over the last 24 hours?
- Give me a detailed market summary for SOL/USDT on Kraken
- What's the trading volume history for BNB/USDT over the last week?

技术细节

依赖项

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

建筑

服务器使用:

  • CCXT对高效交换通信的异步支持
  • MCP的LLM集成工具系统
  • 标准化数据格式,实现一致的输出
  • 连接池实现最佳性能

错误处理

服务器为以下对象实现了稳健的错误处理:

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

发展

运行测试

# To be implemented
pytest tests/

贡献

  1. 复刻仓库
  2. 创建要素分支
  3. 进行更改
  4. 提交拉取请求

地方发展

# Clone the repository
git clone [repository-url]
cd crypto-mcp-server

# Install dependencies
uv pip install -e .

故障排除

常见问题

  1. Exchange连接错误

    • 检查您的互联网连接
    • 验证交换机是否正常运行
    • 确保所选交易所存在交易对
  2. 速率限制

    • 实现请求之间的延迟
    • 使用不同的交易所进行高频查询
    • 检查特定汇率限制
  3. 数据格式问题

    • 验证交易对格式(例如,BTC/USDT,而不是BTCUSD)
    • 检查时间表规格
    • 确保数值参数在有效范围内

许可证

MIT许可证-有关详细信息,请参阅许可证文件