Servidor MCP de Uniswap PoolSpy

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

Características

Supervisa la creación de pools de Uniswap V3 en 9 redes blockchain.
Rango de tiempo personalizable y límites de resultados para consultar nuevos grupos.
Admite clasificación por marca de tiempo, recuento de transacciones, volumen o TVL.

Prerrequisitos

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

Instalación

Clonar el repositorio :
git clone https://github.com/yourusername/uniswap-poolspy-mcp.git cd uniswap-poolspy-mcp
Configurar el entorno : Instale uv si aún no lo ha hecho:
curl -LsSf https://astral.sh/uv/install.sh | sh
Instalar dependencias : use uv para sincronizar las dependencias desde pyproject.toml :
uv sync
Configurar la clave API : Cree un archivo .env en la raíz del proyecto:
echo "THEGRAPH_API_KEY=your-api-key-here" > .env
Reemplace your-api-key-here con su clave API de The Graph real.

Uso

Ejecución del servidor

Inicie el servidor MCP:

uv run main.py

Para el desarrollo con MCP Inspector:

uv run mcp dev main.py

Integración con Claude Desktop

Instalar el servidor como un complemento MCP:

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

Configuración

Para que los clientes MCP puedan descubrir el servidor (por ejemplo, Claude Desktop), configúrelo 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"
      }
    }
  }
}

Consulta de nuevos pools

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

"Muéstrame los nuevos pools de Ethereum de los últimos 10 minutos"
Lista de grupos en la Base ordenados por volumen, límite de 50.
"¿Qué grupos se crearon en Polygon durante la última hora, ordenados por TVL?"

La herramienta acepta estos parámetros:

chain : red blockchain (p. ej., "ethereum", "base", "optimism")
order_by : Campo de ordenamiento ("marca de tiempo", "recuento de transacciones", "volumen", "tvl")
time_range_seconds : Período de retrospección en segundos (predeterminado: 300)
limit : Número máximo de grupos 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 soportadas

Ethereum
Base
Optimismo
Arbitrum
Polígono
Cadena inteligente BNB (BSC)
Avalancha
Celo
Explosión

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

uniswap-poolspy-mcp

Integrations