Uniswap Pools MCP

🚀 Uniswap Pools MCP

Uniswap Pools MCP 是一个 MCP 服务器，可通过代币地址查询 Uniswap 池/交易对，提供简洁、结构化的结果，便于集成和分析。

✨ 主要特性

• 查询 Uniswap 池/交易对：
  • 为给定的代币地址获取 V2、V3 和 V4 池/交易对。
  • 按版本（v2、v3、v4）和 ID 检索特定池/交易对的详细信息。
• 格式化输出：
  • 对于组合池查询，以 Markdown 表格形式返回数据。
  • 对于特定池/交易对查询，提供包含代币地址的 Markdown 文本摘要。

📦 安装指南

前提条件

• Python：版本 3.10 或更高。
• uv：一个 Python 包管理器（推荐用于依赖管理）。
• The Graph API 密钥：查询子图时需要。可从 The Graph 获取。

安装步骤

1. 克隆仓库：

   git clone https://github.com/kukapay/uniswap-pools-mcp.git
   cd uniswap-pools-mcp
   

2. 安装依赖项：

   uv sync
   

3. 安装到 Claude 桌面端： 将服务器作为 Claude 桌面应用程序安装：

   uv run mcp install main.py --name "Uniswap Pools"
   

配置文件参考如下：

{
    "mcpServers": {
        "Uniswap Pools": {
            "command": "uv",
            "args": [ "--directory", "/path/to/uniswap-pools-mcp", "run", "main.py" ],
            "env": { "THEGRAPH_API_KEY": "thegraph-api-key"}               
        }
    }
}

将 /path/to/uniswap-pools-mcp 替换为实际的安装路径，将 thegraph-api-key 替换为从 The Graph 获取的 API 密钥。

💻 使用示例

工具

基础用法

# 获取给定代币地址的所有 Uniswap 池/交易对
def get_token_pools(token_address: str) -> str:

• 描述：查询给定代币地址的所有 Uniswap V2、V3 和 V4 池/交易对。
• 参数：
  • token_address (str)：代币的以太坊地址（例如，USDC 的 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48）。
• 输出：包含以下列的 Markdown 表格：版本、ID、交易对、费用层级、美元交易量、流动性/储备美元、美元费用。
• 示例： 输入：

  Get Uniswap pools for token at address 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
  

  输出：

  | 版本 | ID                                         | 交易对      | 费用层级 | 美元交易量 | 流动性/储备美元 | 美元费用 |
  |------|--------------------------------------------|-------------|----------|------------|---------------------|----------|
  | v2   | 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc | USDC/WETH   | 3000     | 2000000.0  | 500000.0            | N/A      |
  | v3   | 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640 | USDC/WETH   | 500      | 1000000.0  | 123456789           | 5000.0   |
  | v4   | 0x1234567890abcdef1234567890abcdef12345678 | USDC/WETH   | 1000     | 500000.0   | 987654321           | 2500.0   |
  

高级用法

# 按版本和 ID 查询特定的 Uniswap 池/交易对
def get_pool_data(version: str, pool_id: str) -> str:

• 描述：按版本（v2、v3 或 v4）和 ID 查询特定的 Uniswap 池/交易对。
• 参数：
  • version (str)：Uniswap 版本（v2、v3 或 v4）。
  • pool_id (str)：池或交易对的以太坊地址（例如，0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc）。
• 输出：包含以下详细信息的 Markdown 文本：版本、ID、交易对、代币 0 地址、代币 1 地址、费用层级、美元交易量、流动性/储备美元、美元费用。
• 示例： 输入：

  Get Uniswap V2 pool data by ID 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc
  

  输出：

  **Uniswap V2 交易对详情**
  - **版本**：v2
  - **ID**：0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc
  - **交易对**：USDC/WETH
  - **代币 0 地址**：0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
  - **代币 1 地址**：0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
  - **费用层级**：3000 (0.3%)
  - **美元交易量**：2000000.0
  - **流动性/储备美元**：500000.0
  - **美元费用**：N/A
  

📄 许可证

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