Uniswap PoolSpy MCP 服务器

一个 MCP 服务器，用于跟踪 Uniswap 上在九个区块链网络（以太坊、Base、Optimism、Arbitrum、Polygon、BNB 智能链 (BSC)、Avalanche、Celo 和 Blast）上新创建的流动性池，为 DeFi 分析师、交易员和开发者提供实时数据。

功能特性

• 监控 Uniswap V3 在 9 个区块链网络上的池创建。
• 可自定义的时间范围和结果限制，用于查询新池。
• 支持按时间戳、交易计数、交易量或 TVL 排序。

前提条件

• Python 3.10 或更高版本
• uv 用于包管理
• 有效的 The Graph API 密钥
• 兼容 MCP 的环境（例如，Claude Desktop）以实现完整功能

安装

1. 克隆仓库:

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

2. 设置环境: 如果尚未安装 uv，请安装：

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

3. 安装依赖: 使用 uv 从 pyproject.toml 同步依赖项：

   uv sync
   

4. 配置 API 密钥: 在项目根目录中创建一个 .env 文件：

   echo "THEGRAPH_API_KEY=your-api-key-here" > .env
   

   将 your-api-key-here 替换为您的实际 The Graph API 密钥。

使用方法

运行服务器

启动 MCP 服务器：

uv run main.py

用于 MCP Inspector 的开发：

uv run mcp dev main.py

与 Claude Desktop 集成

将服务器安装为 MCP 插件：

uv run mcp install main.py --name "UniswapPoolSpy"

配置

为了使 MCP 客户端（例如 Claude Desktop）可以发现服务器，请在 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"
      }
    }
  }
}

查询新池

在 Claude Desktop 中使用 get_new_pools 工具，使用自然语言查询，例如：

• "显示过去 10 分钟内在以太坊上的新池"
• "列出 Base 上的池，按交易量排序，限制为 50"
• "过去一小时内在 Polygon 上创建了哪些池，按 TVL 排序？"

该工具接受以下参数：

• chain: 区块链网络（例如，“ethereum”、“base”、“optimism”）
• order_by: 排序字段（“timestamp”、“txcount”、“volume”、“tvl”）
• time_range_seconds: 回溯时间段，以秒为单位（默认值：300）
• limit: 要返回的最大池数（默认值：100）

示例输出

新创建的交易池（过去 5 分钟，限制：100）：
池地址：0x1234...abcd
代币：WETH/USDC
创建于：2025-03-18 12:34:56
区块编号：12345678
交易计数：5
交易量（美元）：15000.25
总锁定价值（美元）：50000.75

池地址：0x5678...efgh
代币：DAI/USDT
创建于：2025-03-18 12:33:45
区块编号：12345670
交易计数：3
交易量（美元）：8000.50
总锁定价值（美元）：25000.00

支持的链

• Ethereum
• Base
• Optimism
• Arbitrum
• Polygon
• BNB Smart Chain (BSC)
• Avalanche
• Celo
• Blast

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。