跨链数据分析服务

Wormhole Metrics MCP是一个分析Wormhole协议跨链活动的服务器,提供交易量、顶级资产、源-目标链对和关键性能指标(KPIs)的洞察。

  • by kukapay
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 kukapay/wormhole-metrics-mcp

使用说明

虫洞度量MCP

MCP服务器,分析Wormhole协议上的跨链活动,提供对交易量、顶级资产、源-目标链对和关键性能指标(KPI)的洞察。

特性

  • 综合工具:包括用于跨链活动、资金流、顶级资产、链对、符号、代币走廊和KPI的工具。
  • Markdown输出:以Markdown格式的表格返回数据,以便清晰显示。

安装

先决条件

  • Python 3.10或更高版本
  • 紫外线 (推荐包管理器)

设置

  1. 克隆存储库

    git clone https://github.com/kukapay/wormhole-metrics-mcp.git
    cd wormhole-metrics-mcp
    
  2. 再进行

    uv sync
    
  3. 安装到克劳德桌面:

    将服务器安装为Claude Desktop应用程序:

    uv run mcp install main.py --name "Wormhole Metrics"
    

    配置文件作为参考:

    {
       "mcpServers": {
           "Wormhole Metrics": {
               "command": "uv",
               "args": [ "--directory", "/path/to/wormhole-metrics-mcp", "run", "main.py" ]
           }
       }
    }
    

    替换 /path/to/wormhole-metrics-mcp 使用您的实际安装路径。

用法

这 wormhole-metrics-mcp 服务器通过MCP接口公开了几个工具。下面是这些工具及其用法的概述。

工具

  1. get_cross_chain活动

    • 描述:获取跨链活动数据,返回源链和目标链之间的卷透视表。
    • 参数:
      • timeSpan: 7d, 30d, 90d, 1y, all-time (默认值: 7d)
      • by: notional, tx count (默认值: notional)
      • app:逗号分隔的应用程序列表(默认值:空)
    • 示例:
      • 提示:“显示过去7天的跨链活动,按名义交易量计算。”
      • 输出:
        | source_chain | Solana | Ethereum | Base       |
        |--------------|--------|---------|------------|
        | Mantle       | 23.545 |         |            |
        | Polygon      |        | 245951  | 747048     |
        
  2. get_money_flow

    • 描述:检索特定期间的交易计数和交易量数据。
    • 参数:
      • timespan: 1h, 1d, 1mo, 1y (默认值: 1d)
      • from_dateISO 8601格式(例如。, 2024-01-01T15:04:05Z,默认值:空)
      • to_date:ISO 8601格式(默认值:空)
      • appId:应用程序ID(默认值:空)
      • sourceChain:源链ID(默认值:空)
      • targetChain:目标链ID(默认值:空)
    • 示例:
      • 提示:“获取Solana作为源链在过去一天的交易计数和交易量。”
      • 输出:
        | from                 | to                   | source_chain | volume            | count |
        |----------------------|----------------------|--------------|-------------------|-------|
        | 2025-01-01T00:00:00Z | 2025-01-02T00:00:00Z | Solana       | 346085661921482   | 550   |
        | 2025-01-02T00:00:00Z | 2025-01-03T00:00:00Z | Solana       | 1915450117554795  | 747   |
        
  3. get_top_assets_by_volume

    • 描述:按数量列出顶级资产,包括发射器链和令牌链。
    • 参数:
      • timeSpan: 7d, 15d, 30d (默认值: 7d)
    • 示例:
      • 提示:“按交易量列出过去15天的顶级资产。”
      • 输出:
        | emitter_chain | symbol | token_chain | token_address                            | volume         |
        |---------------|--------|-------------|------------------------------------------|----------------|
        | Solana        | WBTC   | Ethereum    | 0000000000000000000000002260fac5e5542a773aa44fbcfedf7c193bc2c599 | 25101807.78824 |
        | Ethereum      | RNDR   | Ethereum    | 0000000000000000000000006de037ef9ad2725eb40118bb1702ebb27e4aeb24 | 9829032.688    |
        
  4. get_top_chain_pairs_by_num传输

    • 描述:按传输次数返回顶级链对。
    • 参数:
      • timeSpan: 7d, 15d, 30d (默认值: 7d)
    • 示例:
      • 提示:“按过去7天的转账次数显示顶级链对。”
      • 输出:
        | source_chain | destination_chain | number_of_transfers |
        |--------------|-------------------|---------------------|
        | Optimism     | Solana            | 2849                |
        | Ethereum     | Solana            | 2466                |
        | Base         | Arbitrum          | 1993                |
        
  5. get_top_symbols_by_volume

    • 描述:按交易量和交易计数获取顶部交易品种。
    • 参数:
      • timeSpan: 7d, 15d, 30d (默认值: 7d)
    • 示例:
      • 提示:“过去30天里,按交易量计算,排名靠前的交易品种是什么?”
      • 输出:
        | symbol | volume          | txs |
        |--------|-----------------|-----|
        | WBTC   | 28434555.496489 | 133 |
        | RNDR   | 9829032.688     | 49  |
        | WETH   | 9662352.854166  | 60  |
        
  6. get_top100_载波

    • 描述:按交易数量列出前100个代币走廊。
    • 参数:
      • timeSpan: 2d, 7d (默认值: 2d)
    • 示例:
      • 提示:“获取过去7天交易量排名前100的代币走廊。”
      • 输出:
        | source_chain | target_chain | token_chain | token_address                            | txs |
        |--------------|--------------|-------------|------------------------------------------|-----|
        | Optimism     | Solana       | Optimism    | 000000000000000000000000ef4461891dfb3ac8572ccf7c794664a8dd927945 | 2777|
        | Base         | Arbitrum     | Base        | 000000000000000000000000271cdba25be9be2e024bc0a550012b2e5934420e | 1892|
        
  7. get_kpi_list

    • 描述:检索Wormhole协议的关键性能指标(KPI)。
    • 参数:无
    • 示例:
      • 提示:“给我看看虫洞的关键性能指标。”
      • 输出:
        | 24h_messages | total_messages | total_tx_count | total_volume       | tvl         | 24h_volume   | 7d_volume    | 30d_volume    |
        |--------------|----------------|----------------|--------------------|-------------|--------------|--------------|---------------|
        | 192987       | 1111114235     | 6023755        | 60718344331.570806 | 2582546224  | 22688586.172 | 252786937.009| 1349155202.545|
        

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。