uniswap-poolspy-mcp

Uniswap PoolSpy MCP Server 是一个基于 MCP 协议的服务器，专门用于追踪 Uniswap 在多个区块链网络上新创建的流动性池。它面向 DeFi 分析师、交易者和开发者，提供实时数据，帮助用户及时了解新池动态。

主要能力：

• 监控 Uniswap V3 池在九个区块链网络上的创建情况，包括以太坊、Base、Optimism、Arbitrum、Polygon、BNB Smart Chain（BSC）、Avalanche、Celo 和 Blast。
• 支持自定义查询的时间范围和结果数量限制。
• 支持按时间戳、交易数、交易量或 TVL 进行排序。

使用方式：

1. 环境要求：Python 3.10 或更高版本、uv 包管理工具、有效的 The Graph API 密钥、兼容 MCP 的环境（例如 Claude Desktop）以使用完整功能。
2. 克隆仓库：git clone https://github.com/yourusername/uniswap-poolspy-mcp.git，然后 cd uniswap-poolspy-mcp。
3. 设置环境：如果尚未安装 uv，可运行 curl -LsSf https://astral.sh/uv/install.sh | sh 进行安装。
4. 安装依赖：使用 uv 从 pyproject.toml 同步依赖：uv sync。
5. 配置 API 密钥：在项目根目录创建 .env 文件：echo "THEGRAPH_API_KEY=your-api-key-here" > .env，将 your-api-key-here 替换为实际的 The Graph API 密钥。
6. 运行服务器：启动 MCP 服务器；开发时可使用 MCP Inspector。
7. 与 Claude Desktop 集成：将服务器安装为 MCP 插件，并在 mcpServers 文件中配置，以便 MCP 客户端（如 Claude Desktop）发现该服务器。
8. 查询新池：在 Claude Desktop 中使用 get_new_pools 工具，通过自然语言查询，例如：
   • "Show me new pools on Ethereum from the last 10 minutes"
   • "List pools on Base sorted by volume, limit to 50"
   • "What pools were created on Polygon in the past hour, ordered by TVL?" 该工具接受以下参数：
   • chain：区块链网络（例如 "ethereum"、"base"、"optimism"）
   • order_by：排序字段（"timestamp"、"txcount"、"volume"、"tvl"）
   • time_range_seconds：回溯时间（秒，默认 300）
   • limit：返回的最大池数量（默认 100）

适用场景：

• DeFi 分析师监控新流动性池的创建，以发现早期机会。
• 交易者追踪特定链上的新池，按交易量或 TVL 排序以识别热门池。
• 开发者集成 MCP 服务器，构建自动化监控或分析工具。

限制：

• 需要有效的 The Graph API 密钥。
• 需要 Python 3.10+ 和 uv 环境。
• 完整功能需要兼容 MCP 的环境（如 Claude Desktop）。
• 仅监控 Uniswap V3 池的创建。
• 项目采用 MIT 许可证。