Uniswap PoolSpy

Monitora pools de

GitHub
10
Experimente este MCPPatrocinado

Documentação

Servidor MCP Uniswap PoolSpy

Um servidor MCP que rastreia pools de liquidez recém-criados na Uniswap em nove redes blockchain — Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo e Blast — fornecendo dados em tempo real para analistas de DeFi, traders e desenvolvedores.

Python License Status

Recursos

  • Monitora a criação de pools Uniswap V3 em 9 redes blockchain.
  • Intervalo de tempo personalizável e limites de resultados para consultar novos pools.
  • Suporta ordenação por timestamp, contagem de transações, volume ou TVL.

Pré-requisitos

  • Python 3.10 ou superior
  • uv para gerenciamento de pacotes
  • Uma chave de API The Graph válida
  • Ambiente compatível com MCP (ex.: Claude Desktop) para funcionalidade completa

Instalação

  1. Clonar o Repositório:

    git clone https://github.com/yourusername/uniswap-poolspy-mcp.git
cd uniswap-poolspy-mcp

  2. Configurar o Ambiente: Instale o uv se ainda não o tiver:

    curl -LsSf https://astral.sh/uv/install.sh | sh

  3. Instalar Dependências: Use o uv para sincronizar as dependências do pyproject.toml:

    uv sync

  4. Configurar a Chave de API: Crie um arquivo .env na raiz do projeto:

    echo "THEGRAPH_API_KEY=your-api-key-here" > .env

    Substitua your-api-key-here pela sua chave de API The Graph real.

Uso

Executando o Servidor

Inicie o servidor MCP:

uv run main.py

Para desenvolvimento com o MCP Inspector:

uv run mcp dev main.py

Integração com o Claude Desktop

Instale o servidor como um plugin MCP:

uv run mcp install main.py --name "UniswapPoolSpy"

Configuração

Para tornar o servidor detectável por clientes MCP (ex.: Claude Desktop), configure-o em um arquivo mcpServers:

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

Consultando Novos Pools

Use a ferramenta get_new_pools no Claude Desktop com consultas em linguagem natural, como:

  • "Mostre-me novos pools na Ethereum dos últimos 10 minutos"
  • "Liste pools na Base ordenados por volume, limite de 50"
  • "Quais pools foram criados na Polygon na última hora, ordenados por TVL?"

A ferramenta aceita estes parâmetros:

  • chain: Rede blockchain (ex.: "ethereum", "base", "optimism")
  • order_by: Campo de ordenação ("timestamp", "txcount", "volume", "tvl")
  • time_range_seconds: Período de retrospectiva em segundos (padrão: 300)
  • limit: Número máximo de pools a retornar (padrão: 100)

Exemplo de Saída

Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
Pool Address: 0x1234...abcd
Tokens: WETH/USDC
Created At: 2025-03-18 12:34:56
Block Number: 12345678
Transaction Count: 5
Volume (USD): 15000.25
Total Value Locked (USD): 50000.75

Pool Address: 0x5678...efgh
Tokens: DAI/USDT
Created At: 2025-03-18 12:33:45
Block Number: 12345670
Transaction Count: 3
Volume (USD): 8000.50
Total Value Locked (USD): 25000.00

Redes Suportadas

  • Ethereum
  • Base
  • Optimism
  • Arbitrum
  • Polygon
  • BNB Smart Chain (BSC)
  • Avalanche
  • Celo
  • Blast

Licença

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