PancakeSwap PoolSpy MCP Server

PancakeSwap PoolSpy MCP 服务

一个用于追踪 Pancake Swap 新建流动性池的 MCP 服务，为 DeFi 分析师、交易员和开发者提供实时数据。

功能

• 实时追踪流动性池：获取指定时间范围内（默认为 5 分钟）创建的流动性池。
• 可自定义查询：调整时间范围（以秒为单位）和返回的流动性池数量（默认为 100 个）。
• 详细指标：包括流动性池地址、代币、创建时间戳、区块编号、交易数量、交易量（美元）和锁仓总价值（美元）。

前提条件

• Python 3.10+：确保系统已安装 Python。
• The Graph API 密钥：从 The Graph 获取 API 密钥，以访问 PancakeSwap 子图。

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 PancakeSwap PoolSpy：

npx -y @smithery/cli install @kukapay/pancakeswap-poolspy-mcp --client claude

1. 克隆代码库：

   git clone https://github.com/kukapay/pancakeswap-poolspy-mcp.git
   cd pancakeswap-poolspy-mcp
   

2. 安装依赖项： 使用 uv 安装所需的 Python 软件包：

   uv add mcp[cli] httpx dotenv
   

3. 客户端配置

   {
     "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"
         }
       }
     }
   }
   

使用方法

运行服务

在开发模式下运行服务，以便在本地进行测试：

mcp dev main.py

这会启动 MCP Inspector，你可以在其中与 get_new_pools_bsc 工具交互。

可用工具

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

获取 BNB Smart Chain 上新创建的 PancakeSwap 流动性池列表。

• 参数：

  • time_range_seconds（int）：回溯查询新流动性池的时间范围，单位为秒。默认值为 300 秒（5 分钟）。
  • limit（int）：返回的流动性池数量上限。默认值为 100 个。

• 返回值：格式化字符串，列出流动性池详情；如果查询失败，则返回错误消息。

• 输出示例：

  • 默认（最近 5 分钟，最多 100 个流动性池）：

    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
    

  • 自定义（最近 10 分钟，最多 50 个流动性池）：

    get_new_pools(600, 50)
    

    Newly Created Trading Pools (Last 10 Minutes, Limit: 50):
    [pool details...]
    

提示词示例：

• “列出过去 1 小时内新创建的 PancakeSwap 流动性池。”
• “显示过去 2 分钟内创建的 PancakeSwap 流动性池。”

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。