Wormhole Metrics MCP

Analiza la actividad entre cadenas en el protocolo Wormhole, proporcionando información sobre volúmenes de transacciones, principales activos e indicadores clave de rendimiento.

GitHubPrueba este MCPPatrocinado

Documentación

Wormhole Metrics MCP

Un servidor MCP que analiza la actividad entre cadenas en el protocolo Wormhole, proporcionando información sobre volúmenes de transacciones, activos principales, pares de cadenas de origen y destino, e indicadores clave de rendimiento (KPIs).

GitHub License Python Version Status

Características

  • Herramientas Integrales: Incluye herramientas para actividad entre cadenas, flujo de dinero, activos principales, pares de cadenas, símbolos, corredores de tokens y KPIs.
  • Salida en Markdown: Devuelve datos como tablas formateadas en Markdown para una presentación clara.

Instalación

Requisitos previos

  • Python 3.10 o superior
  • uv (administrador de paquetes recomendado)

Configuración

  1. Clonar el Repositorio

    git clone https://github.com/kukapay/wormhole-metrics-mcp.git
cd wormhole-metrics-mcp

  2. Instalar Dependencias

    uv sync

  3. Instalación en Claude Desktop:

    Instala el servidor como una aplicación de Claude Desktop:

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

    Archivo de configuración como referencia:

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

    Reemplaza /path/to/wormhole-metrics-mcp con tu ruta de instalación real.

Uso

El servidor wormhole-metrics-mcp expone varias herramientas a través de la interfaz MCP. A continuación se presenta una descripción general de las herramientas y su uso.

Herramientas

  1. get_cross_chain_activity

    • Descripción: Obtiene datos de actividad entre cadenas, devolviendo una tabla dinámica de volúmenes entre cadenas de origen y destino.
    • Parámetros:
      • timeSpan: 7d, 30d, 90d, 1y, all-time (predeterminado: 7d)
      • by: notional, tx count (predeterminado: notional)
      • app: Lista de aplicaciones separadas por comas (predeterminado: vacío)
    • Ejemplo:
      • Solicitud: "Muéstrame la actividad entre cadenas de los últimos 7 días, medida por volumen nocional."
      • Salida: 
        | source_chain | Solana | Ethereum | Base       |
|--------------|--------|---------|------------|
| Mantle       | 23.545 |         |            |
| Polygon      |        | 245951  | 747048     |

  2. get_money_flow

    • Descripción: Recupera datos de número de transacciones y volumen para un período específico.
    • Parámetros:
      • timespan: 1h, 1d, 1mo, 1y (predeterminado: 1d)
      • from_date: Formato ISO 8601 (ej., 2024-01-01T15:04:05Z, predeterminado: vacío)
      • to_date: Formato ISO 8601 (predeterminado: vacío)
      • appId: ID de aplicación (predeterminado: vacío)
      • sourceChain: ID de cadena de origen (predeterminado: vacío)
      • targetChain: ID de cadena de destino (predeterminado: vacío)
    • Ejemplo:
      • Solicitud: "Obtén el número de transacciones y el volumen para Solana como cadena de origen durante el último día."
      • Salida: 
        | 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

    • Descripción: Lista los activos principales por volumen, incluyendo cadenas emisoras y de tokens.
    • Parámetros:
      • timeSpan: 7d, 15d, 30d (predeterminado: 7d)
    • Ejemplo:
      • Solicitud: "Lista los activos principales por volumen de los últimos 15 días."
      • Salida: 
        | 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_transfers

    • Descripción: Devuelve los pares de cadenas principales por número de transferencias.
    • Parámetros:
      • timeSpan: 7d, 15d, 30d (predeterminado: 7d)
    • Ejemplo:
      • Solicitud: "Muestra los pares de cadenas principales por número de transferencias de los últimos 7 días."
      • Salida: 
        | source_chain | destination_chain | number_of_transfers |
|--------------|-------------------|---------------------|
| Optimism     | Solana            | 2849                |
| Ethereum     | Solana            | 2466                |
| Base         | Arbitrum          | 1993                |

  5. get_top_symbols_by_volume

    • Descripción: Obtiene los símbolos principales por volumen y número de transacciones.
    • Parámetros:
      • timeSpan: 7d, 15d, 30d (predeterminado: 7d)
    • Ejemplo:
      • Solicitud: "¿Cuáles son los símbolos principales por volumen en los últimos 30 días?"
      • Salida: 
        | symbol | volume          | txs |
|--------|-----------------|-----|
| WBTC   | 28434555.496489 | 133 |
| RNDR   | 9829032.688     | 49  |
| WETH   | 9662352.854166  | 60  |

  6. get_top100_corridors

    • Descripción: Lista los 100 principales corredores de tokens por número de transacciones.
    • Parámetros:
      • timeSpan: 2d, 7d (predeterminado: 2d)
    • Ejemplo:
      • Solicitud: "Obtén los 100 principales corredores de tokens por transacciones de los últimos 7 días."
      • Salida: 
        | source_chain | target_chain | token_chain | token_address                            | txs |
|--------------|--------------|-------------|------------------------------------------|-----|
| Optimism     | Solana       | Optimism    | 000000000000000000000000ef4461891dfb3ac8572ccf7c794664a8dd927945 | 2777|
| Base         | Arbitrum     | Base        | 000000000000000000000000271cdba25be9be2e024bc0a550012b2e5934420e | 1892|

  7. get_kpi_list

    • Descripción: Recupera los indicadores clave de rendimiento (KPIs) para el protocolo Wormhole.
    • Parámetros: Ninguno
    • Ejemplo:
      • Solicitud: "Muéstrame los indicadores clave de rendimiento para Wormhole."
      • Salida: 
        | 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|

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.