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

1. Clonar el repositorio :

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

2. Configurar el entorno : Instale uv si aún no lo ha hecho:

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

3. Instalar dependencias : use uv para sincronizar las dependencias desde pyproject.toml :

   uv sync

4. 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:

Para el desarrollo con MCP Inspector:

Integración con Claude Desktop

Instalar el servidor como un complemento MCP:

Configuración

Para que los clientes MCP puedan descubrir el servidor (por ejemplo, Claude Desktop), configúrelo en un archivo mcpServers :

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

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.