Crypto Trader MCP 工具用于 Claude Desktop

这是一个使用CoinGecko API提供加密货币市场数据的MCP（模型上下文协议）工具，特别设计用于Claude Desktop。

教程

要详细了解如何设置和使用此工具，请参阅我们的Medium教程： 教程：使用Claude Desktop与Crypto Trader MCP工具获取实时加密货币数据

功能

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

设置

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

2. 安装依赖项：

pip install -r requirements.txt

与Claude Desktop集成

1. 在Claude Desktop中配置您的MCP设置，通过在您的MCP配置中添加以下内容：

{
  "mcpServers": {
    "crypto-trader": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
    }
  }
}

2. 将路径替换为您main.py文件的完整路径
3. 使用以下命令运行服务器：

py -3.13 main.py

4. 在使用Claude Desktop时保持服务器运行

可用工具

1. get_crypto_price

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

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

2. get_crypto_market_data

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

{
    "symbol": "ETH",
    "name": "以太坊",
    "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. get_crypto_historical_data

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

{
    "symbol": "BTC",
    "name": "比特币",
    "days": 30,
    "prices": [
        {
            "date": "2025-02-15T00:00:00",
            "price": 62150.23
        },
        {
            "date": "2025-02-16T00:00:00",
            "price": 63421.15
        }
        // ... 更多数据点
    ]
}

4. search_crypto

搜索加密货币：

{
    "results": [
        {
            "id": "bitcoin",
            "symbol": "BTC",
            "name": "比特币"
        },
        {
            "id": "bitcoin-cash",
            "symbol": "BCH",
            "name": "比特币现金"
        }
        // ... 更多结果
    ]
}

5. get_trending_crypto

获取热门加密货币：

{
    "trending_coins": [
        {
            "id": "pendle",
            "name": "Pendle",
            "symbol": "PENDLE",
            "market_cap_rank": 85,
            "price_btc": 0.00002356
        }
        // ... 更多热门加密货币
    ]
}

6. get_global_crypto_data

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

{
    "active_cryptocurrencies": 12875,
    "markets": 892,
    "total_market_cap_usd": 2347890123456,
    "total_volume_usd": 89723456789,
    "market_cap_percentage": {
        "BTC": 52.4,
        "ETH": 18.2
        // ... 更多加密货币
    },
    "updated_at": "2025-03-15T10:30:00"
}

示例查询

您可以向Claude Desktop提问如下问题：

• "比特币当前的价格是多少？"
• "显示以太坊的详细市场数据"
• "过去30天狗狗币的价格历史是什么？"
• "搜索与'sol'相关的加密货币"
• "今天哪些加密货币很受欢迎？"
• "当前的总加密货币市场资本化是多少？"

错误处理

所有工具都包括适当的错误处理，并且如果出现问题，会返回错误消息：

{
    "error": "无法获取INVALID_SYMBOL的价格"
}

故障排除

如果MCP服务器在Claude Desktop中不起作用：

1. 确保服务器正在运行——启动脚本时应看到输出
2. 验证设置中的路径是否正确且是绝对路径
3. 确保系统PATH中有Python 3.10+
4. 检查所有依赖项是否已安装
5. 尝试重新启动Claude Desktop
6. 查看日志是否有任何错误消息

请求限制

此工具使用免费的CoinGecko API，该API有请求限制。请注意，非常频繁的请求可能会被API限制。

许可证

MIT许可证