Uniswap PoolSpy

Servidor MCP Uniswap PoolSpy

Un servidor MCP que rastrea pools de liquidez recién creados en Uniswap en nueve redes blockchain — Ethereum, Base, Optimism, Arbitrum, Polygon, BNB Smart Chain (BSC), Avalanche, Celo y Blast — proporcionando datos en tiempo real para analistas DeFi, traders y desarrolladores.

Características

• Monitorea la creación de pools de Uniswap V3 en 9 redes blockchain.
• Rango de tiempo personalizable y límites de resultados para consultar nuevos pools.
• Soporta ordenamiento por marca de tiempo, número de transacciones, volumen o TVL.

Requisitos previos

• Python 3.10 o superior
• uv para gestión de paquetes
• Una clave de API de The Graph válida
• Entorno compatible con MCP (por ejemplo, Claude Desktop) para funcionalidad completa

Instalación

1. Clonar el repositorio:

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

2. Configurar el entorno: Instala uv si aún no lo tienes:

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

3. Instalar dependencias: Usa uv para sincronizar dependencias desde pyproject.toml:

   uv sync
   

4. Configurar la clave de API: Crea un archivo .env en la raíz del proyecto:

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

   Reemplaza your-api-key-here con tu clave real de The Graph API.

Uso

Ejecutar el servidor

Inicia el servidor MCP:

uv run main.py

Para desarrollo con MCP Inspector:

uv run mcp dev main.py

Integración con Claude Desktop

Instala el servidor como un plugin de MCP:

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

Configuración

Para que el servidor sea detectable por clientes MCP (por ejemplo, Claude Desktop), configúralo en un archivo 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"
      }
    }
  }
}

Consultar nuevos pools

Usa la herramienta get_new_pools en Claude Desktop con consultas en lenguaje natural como:

• "Muéstrame nuevos pools en Ethereum de los últimos 10 minutos"
• "Lista pools en Base ordenados por volumen, limita a 50"
• "¿Qué pools se crearon en Polygon en la última hora, ordenados por TVL?"

La herramienta acepta estos parámetros:

• chain: Red blockchain (por ejemplo, "ethereum", "base", "optimism")
• order_by: Campo de ordenamiento ("timestamp", "txcount", "volume", "tvl")
• time_range_seconds: Período de retroceso en segundos (predeterminado: 300)
• limit: Número máximo de pools a devolver (predeterminado: 100)

Ejemplo de salida

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

Cadenas compatibles

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

Licencia

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