Skip to main content
Glama

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.

PitónLicenciaEstado

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.

Related MCP server: uniswap-trader-mcp

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:

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.

Available Tools

1 tool
get_new_poolsB

Returns a list of trading pools created in the specified time range on Uniswap V3.

Parameters: chain (str): The blockchain on which Uniswap is deployed. Default is 'ethereum'. Supported options include: 'ethereum', 'base', 'optimism', 'arbitrum', 'polygon', 'bsc', 'avalanche', 'celo' and 'blast'. order_by (str): The field to sort data in descending order before returning to the user. Default is 'timestamp'. Supported options include: - timestamp: Sort by Timestamp - txcount: Sort by Transaction Count - tvl: Sort by Total Value Locked - volume: Sort by Volume time_range_seconds (int): The time range in seconds to look back for new pools. Default is 300 seconds (5 minutes). limit (int): The maximum number of pools to return. Default is 100 pools.

Inputs: chain, limit, order_by, time_range_seconds.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The tool 'get_new_pools' has a single, clearly defined purpose: retrieving newly created Uniswap V3 pools within a specified time range.

    Naming Consistency5/5

    Since there is only one tool, naming consistency is inherently perfect. The tool name 'get_new_pools' follows a clear verb_noun pattern (get + new_pools), which would be consistent if more tools were added.

    Tool Count2/5

    A single tool is too few for a server named 'uniswap-poolspy-mcp', which suggests broader monitoring or analysis of Uniswap pools. This minimal toolset limits functionality to only retrieving new pools, lacking operations like querying existing pools, analyzing pool metrics, or tracking pool changes over time.

    Completeness2/5

    The tool surface is severely incomplete for the implied domain of Uniswap pool monitoring. While 'get_new_pools' covers discovery of new pools, there are significant gaps: no tools for getting pool details, tracking liquidity or volume trends, analyzing historical data, or performing CRUD-like operations on pool information, which agents would need for comprehensive analysis.

    Related MCP Connectors

    Related MCP Servers