加密货币趋势追踪服务

一个追踪和监控CoinGecko上最新热门代币的MCP服务器,提供实时加密货币趋势分析。

  • by kukapay
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 kukapay/crypto-trending-mcp

使用说明

加密趋势MCP服务器

一个MCP服务器,跟踪和监控CoinGecko上的最新趋势代币,提供对最流行加密货币的实时洞察。

特性

  • 工具: get_trending_md_doc
    返回完整CoinGecko趋势页面的Markdown文档,其中包括一个趋势加密货币表,列为:排名、名称、符号、价格、1小时变化、24小时变化、7天变化、24天交易量、市值。

  • 提示: parse_trending_md_doc
    指导MCP客户端从Markdown文档中提取趋势硬币表,并使用LLM进行解析,支持识别价格变化积极的硬币或按市值排名等分析。

  • 无缝集成
    专为与Claude Desktop配合使用而设计,允许自然语言查询通过MCP工具和提示分析趋势加密数据。

  • 轻量级和可扩展性
    以最小的依赖性和简单的架构构建,使其易于扩展或部署。

安装

先决条件

  • Python 3.10+
  • Node.js (用于Playwright浏览器依赖项)
  • 克劳德桌面 (可选,用于使用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桌面:

    • 编辑配置文件:

      • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
      • 视窗: %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。
    • 寻找锤子图标(🔨) 在输入框中,指示MCP工具可用。
  3. 与服务器交互:

    • 问自然语言问题,比如:
      • “24小时价格变化积极的加密货币趋势是什么?”
      • “按市值显示前三大趋势硬币。”
    • 克劳德将使用 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 prompt引导LLM提取表格并生成结构化输出,例如:

[
  {
    "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文件。