Servidor MCP de PancakeSwap PoolSpy

Un servidor MCP que rastrea los grupos de liquidez recién creados en Pancake Swap, proporcionando datos en tiempo real para analistas, comerciantes y desarrolladores de DeFi.

Características

• Seguimiento de grupos en tiempo real : recupera los grupos creados dentro de un rango de tiempo específico (valor predeterminado: 5 minutos).
• Consultas personalizables : ajuste el rango de tiempo (en segundos) y la cantidad de grupos devueltos (valor predeterminado: 100).
• Métricas detalladas : incluye dirección de pool, tokens, marca de tiempo de creación, número de bloque, recuento de transacciones, volumen (USD) y valor total bloqueado (USD).

Prerrequisitos

• Python 3.10+ : asegúrese de que Python esté instalado en su sistema.
• Clave API de The Graph : obtenga una clave API de The Graph para acceder al subgráfico PancakeSwap.

Instalación

1. Clonar el repositorio :
   git clone https://github.com/kukapay/pancakeswap-poolspy-mcp.git cd pancakeswap-poolspy-mcp
2. Instalar dependencias : Instale los paquetes de Python necesarios usando uv:
   uv add mcp[cli] httpx dotenv
3. Configuración del cliente
   { "mcpServers": { "PancakeSwap-PoolSpy": { "command": "uv", "args": ["--directory", "path/to/pancakeswap-poolspy-mcp", "run", "main.py"], "env": { "THEGRAPH_API_KEY": "your api key from The Graph" } } } }

Uso

Ejecución del servidor

Ejecute el servidor en modo de desarrollo para probarlo localmente:

Esto inicia el Inspector MCP, donde puedes interactuar con la herramienta get_new_pools_bsc .

Herramienta disponible

get_new_pools_bsc(time_range_seconds: int = 300, limit: int = 100)

Obtiene una lista de grupos de PancakeSwap recién creados en BNB Smart Chain.

• Parámetros :
  • time_range_seconds (int): Intervalo de tiempo en segundos para buscar nuevos grupos. El valor predeterminado es 300 segundos (5 minutos).
  • limit (int): Número máximo de grupos a devolver. El valor predeterminado es 100 grupos.
• Devuelve : una cadena formateada que enumera los detalles del grupo o un mensaje de error si la consulta falla.
• Ejemplos de salidas :
  • Predeterminado (últimos 5 minutos, hasta 100 grupos):
    get_new_pools_bsc()
    Newly Created Trading Pools (Last 5 Minutes, Limit: 100): Pool Address: 0x1234...5678 Tokens: WETH/USDC Created At: 2025-03-16 12:00:00 UTC Block Number: 12345678 Transaction Count: 10 Volume (USD): 1234.56 Total Value Locked (USD): 5678.90 Pool Address: 0x9abc...def0 Tokens: CAKE/BNB Created At: 2025-03-16 12:01:00 UTC Block Number: 12345679 Transaction Count: 5 Volume (USD): 789.12 Total Value Locked (USD): 3456.78
  • Personalizado (últimos 10 minutos, hasta 50 pools):
    get_new_pools(600, 50)
    Newly Created Trading Pools (Last 10 Minutes, Limit: 50): [pool details...]

Ejemplos de indicaciones :

• "Enumera los grupos de PancakeSwap recién creados en las últimas 1 hora".
• "Mostrar los pools de PancakeSwap creados en los últimos 2 minutos".

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.