Crypto Trending MCP Server

加密货币趋势 MCP 服务

一个 MCP 服务，用于跟踪和监控 CoinGecko 上最新的热门代币，实时了解最受欢迎的加密货币。

功能

• 工具：get_trending_md_doc
  返回 CoinGecko 热门页面的完整 Markdown 文档，其中包含热门加密货币表格，列包括：排名、名称、代号、价格、1 小时涨跌幅、24 小时涨跌幅、7 天涨跌幅、24 小时交易量、市值。

• 提示词：parse_trending_md_doc
  指导 MCP 客户端从 Markdown 文档中提取热门币种表格，并使用大模型解析，支持分析价格正向变化的币种或按市值排名等操作。

• 无缝集成
  专为与 Claude Desktop 配合使用而设计，可通过 MCP 工具和提示词以自然语言查询分析热门加密货币数据。

• 轻量且易扩展
  采用最少的依赖和简洁的架构构建，便于扩展或部署。

安装

先决条件

• Python 3.10+
• Node.js（用于 Playwright 浏览器依赖）
• Claude Desktop（可选，用于通过 MCP 客户端测试）

步骤

1. 克隆仓库：

   git clone https://github.com/kukapay/crypto-trending-mcp.git
   cd crypto-trending-mcp
   

2. 使用 uv 安装依赖：

   uv sync
   playwright install
   

使用方法

与 Claude Desktop 集成

1. 配置 Claude Desktop：

   • 编辑配置文件：

     • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
     • Windows：%APPDATA%\Claude\claude_desktop_config.json

   • 添加服务配置：

     {
       "mcpServers": {
         "crypto-trending": {
           "command": "uv",
           "args": [
             "--directory",
             "/absolute/path/to/crypto-trending-mcp",
             "run",
             "main.py"
           ]
         }
       }
     }
     

     将 /absolute/path/to/crypto-trending-mcp 替换为 main.py 的绝对路径。

2. 重启 Claude Desktop：

   • 关闭并重新打开 Claude Desktop。
   • 查看输入框中的锤子图标（🔨），该图标表示 MCP 工具已可用。

3. 与服务交互：

   • 使用自然语言提问，例如：
     • “哪些热门加密货币的 24 小时价格涨幅为正？”
     • “显示按市值排名的前 3 个热门币种。”
   • Claude 将使用 get_trending_md_doc 工具和 parse_trending_md_doc 提示词获取并分析数据。

输出示例

get_trending_md_doc 工具会返回如下 Markdown 文档：

# Trending Crypto

...

| Rank | Name        | Symbol | Price      | 1h Change | 24h Change | 7d Change | 24h Volume      | Market Cap         |
|------|-------------|--------|------------|-----------|------------|-----------|-----------------|-------------------|
| 1    | Bitcoin     | BTC    | $67,890.12 | +0.45%    | +2.34%     | +10.12%   | $45,123,456,789 | $1,345,678,901,234 |
| 2    | Ethereum    | ETH    | $2,456.78  | -0.12%    | -1.12%     | +5.67%    | $20,987,654,321 | $295,123,456,789   |
| 3    | Solana      | SOL    | $167.45    | +0.89%    | +5.67%     | +15.34%   | $3,456,789,123  | $78,901,234,567    |

...

*Data from CoinGecko*

parse_trending_md_doc 提示词会指导大模型提取表格并生成结构化输出，例如：

[
  {
    "rank": 1,
    "name": "Bitcoin",
    "symbol": "BTC",
    "price": "$67,890.12",
    "change_1h": "+0.45%",
    "change_24h": "+2.34%",
    "change_7d": "+10.12%",
    "volume_24h": "$45,123,456,789",
    "market_cap": "$1,345,678,901,234"
  },
  ...
]

许可证

本项目采用 MIT 许可证授权。详情请参阅 LICENSE 文件。