Uniswap Poolspy MCP

Uniswap PoolSpy MCP服务器

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

特性

• 监控跨9个区块链网络的Uniswap V3池创建。
• 查询新池的可自定义时间范围和结果限制。
• 支持按时间戳、事务计数、卷或TVL排序。

先决条件

• Python 3.10或更高版本
• 紫外线 用于包管理
• A有效 Graph API键
• MCP兼容环境（如Claude Desktop），实现完整功能

安装

1. 克隆存储库:

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

1. 设置环境:

安装 uv 如果你还没有：

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

1. 再进行:

使用 uv 从同步依赖关系 pyproject.toml:

   uv sync

1. 配置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"
      }
    }
  }
}

查询新池

使用 get_new_pools Claude Desktop中的工具，带有自然语言查询，如：

• “显示最近10分钟以太坊上的新池”
• 列出Base上按卷排序的池，限制为50个
• “在过去的一个小时里，TVL在Polygon上创建了哪些池？”

该工具接受以下参数：

• chain：区块链网络（例如，“以太坊”、“基础”、“乐观主义”）
• order_by：排序字段（“时间戳”、“txcount”、“音量”、“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

支撑链

• 以太坊
• 基础
• 乐观主义
• 仲裁
• 多边形
• BNB智能链（BSC）
• 雪崩
• 细胞
• 爆炸

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。