uniswap-poolspy-mcp

by kukapay
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Uses .ENV files to securely store and configure API keys for The Graph, enabling authenticated access to blockchain data across multiple networks

  • Monitors newly created Uniswap V3 liquidity pools on the Ethereum blockchain, providing real-time data on pool creation, transaction counts, volume, and TVL

  • Provides repository-based installation via git clone from GitHub, with structured project organization and documentation

Uniswap PoolSpy MCP 服务器

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

特征

  • 监控 9 个区块链网络中的 Uniswap V3 池创建。
  • 可定制查询新池的时间范围和结果限制。
  • 支持按时间戳、交易数量、交易量或 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. 安装依赖项:使用uvpyproject.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 分钟内以太坊上的新矿池”
  • “按容量排序列出基地上的池,限制为 50 个”
  • “过去一小时内,Polygon 上创建了哪些矿池,按 TVL 排序?”

该工具接受以下参数:

  • chain :区块链网络(例如“以太坊”、“基础”、“乐观”)
  • 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

支持的链

  • 以太坊
  • 根据
  • 乐观
  • 仲裁
  • 多边形
  • BNB智能链(BSC)
  • 雪崩
  • 塞洛
  • 爆炸

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。

-
security - not tested
A
license - permissive license
-
quality - not tested

MCP 服务器可跟踪九个区块链网络上 Uniswap 上新创建的流动性池。

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Running the Server
          2. Integrating with Claude Desktop
          3. Configuration
          4. Querying New Pools
          5. Example Output
        2. Supported Chains
          1. License
            ID: 77r16dv4hj