Servidor MCP Whale Tracker

O que o servidor MCP “Whale Tracker” faz?

O whale-tracker-mcp é uma implementação em Python do Model Context Protocol (MCP) que conecta assistentes de IA à API Whale Alert para permitir o rastreamento e análise em tempo real de grandes transações de criptomoedas, comumente conhecidas como movimentações de “baleias”. Ao expor ferramentas, recursos e templates de prompt para clientes compatíveis com MCP, esse servidor permite que desenvolvedores, analistas e entusiastas de criptomoedas monitorem transferências significativas em blockchain diretamente em seus fluxos de trabalho com LLM. Com recursos como chamadas assíncronas de API, exposição de recursos e gerenciamento seguro de chaves de API, o whale-tracker-mcp potencializa o desenvolvimento orientado por IA ao tornar acessível a atividade de baleias mais recente para conscientização contextual, análise automatizada e automação de fluxos de trabalho.

Lista de Prompts

• query_whale_activity: Um template de prompt reutilizável para análise de padrões de transações de baleias, opcionalmente filtrados por blockchain.

Lista de Recursos

• whale://transactions/{blockchain}: Expõe transações recentes de baleias para um blockchain especificado como dado contextual para LLMs e clientes.

Lista de Ferramentas

• get_recent_transactions: Busca transações recentes de baleias com filtros opcionais de blockchain, valor mínimo de transação e limite de resultados.
• get_transaction_details: Recupera informações detalhadas sobre uma transação de baleia específica pelo seu ID único.

Casos de Uso deste Servidor MCP

• Monitoramento de Baleias em Tempo Real: Permite que desenvolvedores e analistas acompanhem grandes transações de criptomoedas em diversas blockchains em tempo real, auxiliando na análise de sentimento de mercado e estratégias de trading.
• Análise de Padrões de Baleias: Fornece templates de prompt e recursos para assistentes de IA analisarem dados históricos e ao vivo de transações, identificando tendências e anomalias no comportamento de baleias.
• Alertas & Relatórios Automatizados: Integração com ferramentas de fluxo de trabalho para notificar usuários ou disparar ações ao detectar movimentações significativas de baleias.
• Rastreamento Específico por Blockchain: Filtre e exponha atividade de baleias em blockchains específicas (ex: Bitcoin, Ethereum), apoiando pesquisas focadas ou avaliações de risco.
• Enriquecimento de Apps com LLM: Fornece dados contextuais de transações de baleias para aprimorar a saída e raciocínio de aplicativos de IA em trading, compliance ou analytics.

Como configurar

Windsurf

1. Certifique-se de ter Node.js e Windsurf instalados.
2. Localize seu arquivo de configuração do Windsurf (ex: windsurf.config.json).
3. Adicione o servidor MCP Whale Tracker à seção mcpServers:

   {
     "mcpServers": {
       "whale-tracker": {
         "command": "python",
         "args": ["-m", "whale-tracker-mcp"]
       }
     }
   }
   

4. Salve a configuração e reinicie o Windsurf.
5. Verifique se o servidor está rodando e acessível no Windsurf.

Protegendo Chaves de API

Defina sua chave de API Whale Alert usando variáveis de ambiente:

{
  "env": {
    "WHALE_ALERT_API_KEY": "<your_api_key_here>"
  }
}

Claude

1. Certifique-se de ter Node.js e Claude Desktop instalados.
2. Abra a configuração do Claude Desktop (normalmente claude.config.json).
3. Adicione o servidor MCP Whale Tracker da seguinte forma:

   {
     "mcpServers": {
       "whale-tracker": {
         "command": "python",
         "args": ["-m", "whale-tracker-mcp"]
       }
     }
   }
   

4. Salve sua configuração e reinicie o Claude Desktop.
5. Confirme a integração verificando o whale-tracker na lista de ferramentas.

Protegendo Chaves de API

Use uma entrada de variável de ambiente:

{
  "env": {
    "WHALE_ALERT_API_KEY": "<your_api_key_here>"
  }
}

Cursor

1. Instale Node.js e Cursor.
2. Abra seu arquivo de configuração do Cursor (ex: cursor.config.json).
3. Registre o servidor MCP Whale Tracker:

   {
     "mcpServers": {
       "whale-tracker": {
         "command": "python",
         "args": ["-m", "whale-tracker-mcp"]
       }
     }
   }
   

4. Salve a configuração e reinicie o Cursor.
5. Verifique se o servidor está disponível na interface do Cursor.

Protegendo Chaves de API

Adicione sua chave de API de forma segura:

{
  "env": {
    "WHALE_ALERT_API_KEY": "<your_api_key_here>"
  }
}

Cline

1. Certifique-se de que Node.js e Cline estão instalados.
2. Abra a configuração do Cline (ex: cline.config.json).
3. Adicione o servidor MCP Whale Tracker ao bloco mcpServers:

   {
     "mcpServers": {
       "whale-tracker": {
         "command": "python",
         "args": ["-m", "whale-tracker-mcp"]
       }
     }
   }
   

4. Salve e reinicie o Cline.
5. Verifique se o servidor está registrado.

Protegendo Chaves de API

Defina sua chave de API como variável de ambiente:

{
  "env": {
    "WHALE_ALERT_API_KEY": "<your_api_key_here>"
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo de trabalho FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "whale-tracker": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “whale-tracker” para o nome real do seu servidor MCP e substituir a URL pela URL do seu servidor MCP.

Visão Geral

Minha opinião: O MCP Whale Tracker oferece uma integração focada e bem-documentada para rastreamento de baleias cripto, com ferramentas, prompt e exposição de recursos claros. Suas instruções de configuração e segurança são completas para ambientes MCP. Roots e sampling não são documentados. O projeto é mantido, tem estrelas/forks e é licenciado MIT. Eu daria nota 7/10: forte para seu propósito e documentação, mas faltam recursos MCP avançados.

Pontuação MCP