Wormhole Metrics MCP

Analisa a atividade cross-chain no protocolo Wormhole, fornecendo insights sobre volumes de transações, principais ativos e indicadores-chave de desempenho.

GitHubExperimente este MCPPatrocinado

Documentação

Wormhole Metrics MCP

Um servidor MCP que analisa a atividade cross-chain no protocolo Wormhole, fornecendo insights sobre volumes de transações, principais ativos, pares de cadeias origem-destino e indicadores-chave de desempenho (KPIs).

GitHub License Python Version Status

Recursos

  • Ferramentas Abrangentes: Inclui ferramentas para atividade cross-chain, fluxo de dinheiro, principais ativos, pares de cadeias, símbolos, corredores de tokens e KPIs.
  • Saída em Markdown: Retorna dados como tabelas formatadas em Markdown para apresentação clara.

Instalação

Pré-requisitos

  • Python 3.10 ou superior
  • uv (gerenciador de pacotes recomendado)

Configuração

  1. Clone o Repositório

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

  2. Instale as Dependências

    uv sync

  3. Instalação no Claude Desktop:

    Instale o servidor como uma aplicação do Claude Desktop:

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

    Arquivo de configuração como referência:

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

    Substitua /path/to/wormhole-metrics-mcp pelo seu caminho real de instalação.

Uso

O servidor wormhole-metrics-mcp expõe várias ferramentas por meio da interface MCP. Abaixo está uma visão geral das ferramentas e seu uso.

Ferramentas

  1. get_cross_chain_activity

    • Descrição: Busca dados de atividade cross-chain, retornando uma tabela dinâmica de volumes entre cadeias de origem e destino.
    • Parâmetros:
      • timeSpan: 7d, 30d, 90d, 1y, all-time (padrão: 7d)
      • by: notional, tx count (padrão: notional)
      • app: Lista de aplicativos separados por vírgula (padrão: vazio)
    • Exemplo:
      • Prompt: "Mostre-me a atividade cross-chain dos últimos 7 dias, medida por volume nocional."
      • Saída: 
        | source_chain | Solana | Ethereum | Base       |
|--------------|--------|---------|------------|
| Mantle       | 23.545 |         |            |
| Polygon      |        | 245951  | 747048     |

  2. get_money_flow

    • Descrição: Recupera dados de contagem de transações e volume para um período específico.
    • Parâmetros:
      • timespan: 1h, 1d, 1mo, 1y (padrão: 1d)
      • from_date: Formato ISO 8601 (ex.: 2024-01-01T15:04:05Z, padrão: vazio)
      • to_date: Formato ISO 8601 (padrão: vazio)
      • appId: ID do aplicativo (padrão: vazio)
      • sourceChain: ID da cadeia de origem (padrão: vazio)
      • targetChain: ID da cadeia de destino (padrão: vazio)
    • Exemplo:
      • Prompt: "Obtenha a contagem de transações e o volume para Solana como cadeia de origem no último dia."
      • Saída: 
        | 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

    • Descrição: Lista os principais ativos por volume, incluindo cadeias emissoras e de tokens.
    • Parâmetros:
      • timeSpan: 7d, 15d, 30d (padrão: 7d)
    • Exemplo:
      • Prompt: "Liste os principais ativos por volume nos últimos 15 dias."
      • Saída: 
        | 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

    • Descrição: Retorna os principais pares de cadeias por número de transferências.
    • Parâmetros:
      • timeSpan: 7d, 15d, 30d (padrão: 7d)
    • Exemplo:
      • Prompt: "Mostre os principais pares de cadeias por número de transferências nos últimos 7 dias."
      • Saída: 
        | source_chain | destination_chain | number_of_transfers |
|--------------|-------------------|---------------------|
| Optimism     | Solana            | 2849                |
| Ethereum     | Solana            | 2466                |
| Base         | Arbitrum          | 1993                |

  5. get_top_symbols_by_volume

    • Descrição: Busca os principais símbolos por volume e contagem de transações.
    • Parâmetros:
      • timeSpan: 7d, 15d, 30d (padrão: 7d)
    • Exemplo:
      • Prompt: "Quais são os principais símbolos por volume nos últimos 30 dias?"
      • Saída: 
        | symbol | volume          | txs |
|--------|-----------------|-----|
| WBTC   | 28434555.496489 | 133 |
| RNDR   | 9829032.688     | 49  |
| WETH   | 9662352.854166  | 60  |

  6. get_top100_corridors

    • Descrição: Lista os 100 principais corredores de tokens por número de transações.
    • Parâmetros:
      • timeSpan: 2d, 7d (padrão: 2d)
    • Exemplo:
      • Prompt: "Obtenha os 100 principais corredores de tokens por transações nos últimos 7 dias."
      • Saída: 
        | source_chain | target_chain | token_chain | token_address                            | txs |
|--------------|--------------|-------------|------------------------------------------|-----|
| Optimism     | Solana       | Optimism    | 000000000000000000000000ef4461891dfb3ac8572ccf7c794664a8dd927945 | 2777|
| Base         | Arbitrum     | Base        | 000000000000000000000000271cdba25be9be2e024bc0a550012b2e5934420e | 1892|

  7. get_kpi_list

    • Descrição: Recupera indicadores-chave de desempenho (KPIs) para o protocolo Wormhole.
    • Parâmetros: Nenhum
    • Exemplo:
      • Prompt: "Mostre-me os indicadores-chave de desempenho para Wormhole."
      • Saída: 
        | 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|

Licença

Este projeto está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.