关键词

DeFiPancakeSwap流动性池实时数据交易分析

使用说明

项目简介

PancakeSwap PoolSpy MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，专门用于监控去中心化交易所 PancakeSwap 上新创建的流动性池。它通过 The Graph API 实时抓取数据，并以结构化的方式提供给 LLM 客户端，帮助用户进行 DeFi 市场的分析、交易策略制定等。

主要功能点

  • 实时池子追踪: 自动检测并获取 PancakeSwap 上在指定时间范围内（默认5分钟）新创建的流动性池子信息。
  • 可定制查询: 允许用户自定义查询的时间范围（秒）和返回的池子数量（默认最多100个）。
  • 详细数据指标: 提供每个新池子的详细信息，包括池子地址、交易对的代币符号、创建时间戳、区块号、交易计数、交易量（美元计价）以及总锁定价值（美元计价）。
  • MCP 标准接口: 遵循 MCP 协议，方便 LLM 客户端集成和调用，以工具 (Tool) 的形式提供数据查询能力。

安装步骤

  1. 克隆仓库:

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

  2. 安装依赖: 使用 uv 包管理器安装项目依赖，包括 'mcp[cli]' (MCP 框架及命令行工具), 'httpx' (HTTP 客户端), 'dotenv' (环境变量管理):

    uv add mcp[cli] httpx dotenv

  3. 配置 The Graph API Key:

    • 前往 The Graph 官网获取 API Key。
    • 在项目根目录下创建 '.env' 文件，并添加以下内容，将 'your api key from The Graph' 替换为你获取的 API Key。 
      THEGRAPH_API_KEY=your api key from The Graph

服务器配置

MCP 客户端需要配置以下 JSON 格式信息以连接到 PancakeSwap PoolSpy MCP Server。注意，以下配置仅为示例，'path/to/pancakeswap-poolspy-mcp' 需要替换为实际仓库在您本地文件系统中的路径。

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

配置参数说明:

  • '"PancakeSwap-PoolSpy"': 服务器名称，客户端用此名称标识和调用。
  • '"command": "uv"': 启动服务器的命令，这里使用 'uv' 包管理器来运行 Python 脚本。
  • '"args": ["--directory", "path/to/pancakeswap-poolspy-mcp", "run", "main.py"]': 传递给 'uv' 命令的参数。
    • '--directory "path/to/pancakeswap-poolspy-mcp"': 指定项目目录，请替换为实际路径。
    • '"run", "main.py"': 指示 'uv' 运行项目目录下的 'main.py' 文件。
  • '"env": { "THEGRAPH_API_KEY": "your api key from The Graph" }': 设置环境变量，'THEGRAPH_API_KEY' 用于传递 The Graph API 密钥，请替换为您的实际 API 密钥。

基本使用方法

  1. 启动 MCP 服务器: 在项目根目录下，使用以下命令启动服务器（开发模式，会启动 MCP Inspector 界面）：

    mcp dev main.py

  2. 调用工具 (Tool): 服务器启动后，LLM 客户端可以通过 MCP 协议调用 'get_new_pools_bsc' 工具来查询新创建的 PancakeSwap 池子。

    • 默认参数调用 (查询最近5分钟，最多100个池子):

      get_new_pools_bsc()

    • 自定义参数调用 (查询最近10分钟，最多50个池子):

      get_new_pools_bsc(600, 50)

    工具会返回包含新池子详细信息的文本结果，方便 LLM 理解和使用。

示例 Prompt

以下是一些可以用于提示 LLM 调用此 MCP Server 的示例：

  • "列出最近1小时内 PancakeSwap 上新创建的交易池。"
  • "展示过去2分钟内创建的 PancakeSwap 池子。"

信息

分类

网页与API

访问项目