PancakeSwap PoolSpy

Monitora pools de liquidez recém-criadas no PancakeSwap, fornecendo dados em tempo real para analistas DeFi, traders e desenvolvedores.

Documentação

Servidor MCP PancakeSwap PoolSpy

Um servidor MCP que rastreia pools de liquidez recém-criados na Pancake Swap, fornecendo dados em tempo real para analistas de DeFi, traders e desenvolvedores.

License Python smithery badge

Recursos

  • Rastreamento de Pools em Tempo Real: Busca pools criados dentro de um intervalo de tempo especificado (padrão: 5 minutos).
  • Consultas Personalizáveis: Ajuste o intervalo de tempo (em segundos) e o número de pools retornados (padrão: 100).
  • Métricas Detalhadas: Inclui endereço do pool, tokens, timestamp de criação, número do bloco, contagem de transações, volume (USD) e valor total bloqueado (USD).

Pré-requisitos

  • Python 3.10+: Garanta que o Python esteja instalado no seu sistema.
  • Chave de API do The Graph: Obtenha uma chave de API em The Graph para acessar o subgraph da PancakeSwap.

Instalação

Instalando via Smithery

Para instalar o PancakeSwap PoolSpy para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @kukapay/pancakeswap-poolspy-mcp --client claude
  1. Clone o Repositório:

    git clone https://github.com/kukapay/pancakeswap-poolspy-mcp.git
    cd pancakeswap-poolspy-mcp
    
  2. Instale as Dependências: Instale os pacotes Python necessários usando uv:

    uv add mcp[cli] httpx dotenv
    
  3. Configuração do Cliente

    {
      "mcpServers": {
        "PancakeSwap-PoolSpy": {
          "command": "uv",
          "args": ["--directory", "path/to/pancakeswap-poolspy-mcp", "run", "main.py"],
          "env": {
            "THEGRAPH_API_KEY": "your api key from The Graph"
          }
        }
      }
    }
    

Uso

Executando o Servidor

Execute o servidor em modo de desenvolvimento para testá-lo localmente:

mcp dev main.py

Isso inicia o MCP Inspector, onde você pode interagir com a ferramenta get_new_pools_bsc.

Ferramenta Disponível

get_new_pools_bsc(time_range_seconds: int = 300, limit: int = 100)

Busca uma lista de pools PancakeSwap recém-criados na BNB Smart Chain.

  • Parâmetros:

    • time_range_seconds (int): Intervalo de tempo em segundos para buscar pools novos. O padrão é 300 segundos (5 minutos).
    • limit (int): Número máximo de pools a retornar. O padrão é 100 pools.
  • Retorna: Uma string formatada listando os detalhes dos pools ou uma mensagem de erro se a consulta falhar.

  • Exemplos de Saída:

    • Padrão (últimos 5 minutos, até 100 pools):

      get_new_pools_bsc()
      
      Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
      Pool Address: 0x1234...5678
      Tokens: WETH/USDC
      Created At: 2025-03-16 12:00:00 UTC
      Block Number: 12345678
      Transaction Count: 10
      Volume (USD): 1234.56
      Total Value Locked (USD): 5678.90
      
      Pool Address: 0x9abc...def0
      Tokens: CAKE/BNB
      Created At: 2025-03-16 12:01:00 UTC
      Block Number: 12345679
      Transaction Count: 5
      Volume (USD): 789.12
      Total Value Locked (USD): 3456.78
      
    • Personalizado (últimos 10 minutos, até 50 pools):

      get_new_pools(600, 50)
      
      Newly Created Trading Pools (Last 10 Minutes, Limit: 50):
      [pool details...]
      

Exemplos de Prompts:

  • "liste pools PancakeSwap recém-criados da última 1 hora."
  • "Exiba pools PancakeSwap criados nos últimos 2 minutos."

Licença

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