Uniswap PoolSpy MCP Server

Uniswap PoolSpy MCP 服务

一个 MCP 服务，可跟踪 Uniswap 在九个区块链网络上新创建的流动性池——Ethereum、Base、Optimism、Arbitrum、Polygon、BNB Smart Chain (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 分钟内 Ethereum 上的新池”
• “列出 Base 上的池，按交易量排序，最多显示 50 个”
• “过去一小时内 Polygon 上创建了哪些池？按 TVL 排序”

该工具接受以下参数：

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

输出示例

Newly Created Trading Pools (Last 5 Minutes, Limit: 100):
Pool Address: 0x1234...abcd
Tokens: WETH/USDC
Created At: 2025-03-18 12:34:56
Block Number: 12345678
Transaction Count: 5
Volume (USD): 15000.25
Total Value Locked (USD): 50000.75

Pool Address: 0x5678...efgh
Tokens: DAI/USDT
Created At: 2025-03-18 12:33:45
Block Number: 12345670
Transaction Count: 3
Volume (USD): 8000.50
Total Value Locked (USD): 25000.00

支持的链

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

许可证

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