加密货币交易MCP工具

一款为Claude Desktop设计的加密货币市场数据工具,提供实时价格、历史图表、市场统计等功能。

  • by saintdoresh
  • Python
  • 本地部署
  • 21 星标
  • 更新于
在 GitHub 查看 saintdoresh/crypto-trader-mcp-claudedesktop

使用说明

加密货币交易者MCP工具适用于Claude桌面版

一个MCP(模型上下文协议)工具,使用CoinGecko API提供加密货币市场数据,专为Claude Desktop设计。

教程

如需关于设置和使用此工具的详细指南,请查看我们的Medium教程: 教程:使用Claude桌面版与Crypto Trader MCP工具获取实时加密货币数据

功能

  • 实时加密货币价格数据
  • 加密货币的详细市场信息
  • 历史价格图表
  • 加密货币搜索功能
  • 追踪热门加密货币
  • 全球市场统计数据

设置

  1. 确保已安装Python 3.10或更高版本

  2. 安装依赖项:

pip install -r requirements.txt

与Claude桌面版集成

  1. 在Claude Desktop中配置您的MCP设置,请在您的MCP配置中添加以下内容:
{
  "mcpServers": {
    "crypto-trader": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
    }
  }
}
  1. 将路径替换为你main.py文件的完整路径
  2. 使用以下命令运行服务器:
py -3.13 main.py
  1. 在使用Claude Desktop时保持服务器运行

可用工具

获取加密货币价格

获取实时加密货币价格信息:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "price": 65423.12,
    "change_24h": 2.5,
    "volume_24h": 28345678901,
    "market_cap": 1234567890123,
    "timestamp": "2025-03-15T10:30:00"
}

2. 获取加密货币市场数据

获取加密货币的详细市场信息:

{
    "symbol": "ETH",
    "name": "Ethereum",
    "market_cap_rank": 2,
    "current_price": 3521.48,
    "market_cap": 423456789012,
    "total_volume": 15834567890,
    "high_24h": 3580.25,
    "low_24h": 3475.62,
    "price_change_24h": 45.86,
    "price_change_percentage_24h": 1.32,
    "circulating_supply": 120283456,
    "total_supply": 120283456,
    "max_supply": null,
    "ath": 4878.26,
    "ath_date": "2021-11-10T14:24:11.849Z",
    "atl": 0.432979,
    "atl_date": "2015-10-20T00:00:00.000Z"
}

3. 获取加密货币历史数据

获取加密货币的历史价格数据:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "days": 30,
    "prices": [
        {
            "date": "2025-02-15T00:00:00",
            "price": 62150.23
        },
        {
            "date": "2025-02-16T00:00:00",
            "price": 63421.15
        }
        // ... more data points
    ]
}

4. 搜索加密货币

Search for cryptocurrencies:

{
    "results": [
        {
            "id": "bitcoin",
            "symbol": "BTC",
            "name": "Bitcoin"
        },
        {
            "id": "bitcoin-cash",
            "symbol": "BCH",
            "name": "Bitcoin Cash"
        }
        // ... more results
    ]
}

5. 获取热门加密货币

获取热门加密货币:

{
    "trending_coins": [
        {
            "id": "pendle",
            "name": "Pendle",
            "symbol": "PENDLE",
            "market_cap_rank": 85,
            "price_btc": 0.00002356
        }
        // ... more trending coins
    ]
}

6. 获取全局加密数据

获取全球加密货币市场数据:

{
    "active_cryptocurrencies": 12875,
    "markets": 892,
    "total_market_cap_usd": 2347890123456,
    "total_volume_usd": 89723456789,
    "market_cap_percentage": {
        "BTC": 52.4,
        "ETH": 18.2
        // ... more cryptocurrencies
    },
    "updated_at": "2025-03-15T10:30:00"
}

样本查询

你可以像这样向Claude Desktop提问:

  • 比特币当前的价格是多少
  • “给我展示以太坊的详细市场数据”
  • “过去30天里,狗狗币的价格走势如何?”
  • 搜索与“sol”相关的加密货币
  • 今天哪些加密货币正流行
  • “目前加密货币的总市值是多少?”

错误处理

所有工具都包含适当的错误处理,并且在出现问题时会返回错误信息:

{
    "error": "Failed to fetch price for INVALID_SYMBOL"
}

故障排除

如果MCP服务器在Claude Desktop中无法正常工作:

  1. 确保服务器正在运行 - 你应该在启动脚本时看到输出
  2. 验证您的设置中路径是否正确且为绝对路径
  3. 确保您的系统路径中包含Python 3.10+
  4. 检查所有依赖项是否已安装
  5. 尝试重启Claude桌面版
  6. 检查日志以查找任何错误信息

速率限制

这个工具使用了免费的CoinGecko API,该API有速率限制。请注意,过于频繁的请求可能会被API限制。

许可证

麻省理工学院许可协议