Uniswap PoolSpy MCP 服务器

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

特性

• 监控 Uniswap V3 在 9 个区块链网络上的流动性池创建。
• 可自定义查询新池的时间范围和结果限制。
• 支持按时间戳、交易数量、交易量或总锁仓价值排序。

预备条件

• 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

支持的区块链

• 以太坊
• Base
• Optimism
• Arbitrum
• Polygon
• BNB 智能链（BSC）
• Avalanche
• Celo
• Blast

许可证

本项目采用 MIT 许可证——详情见 LICENSE 文件。