Uniswap 池 MCP

一个用于通过代币地址查询 Uniswap 池/对的 MCP 服务器，提供干净、结构化的结果，便于集成和分析。

特性

• 查询 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 Desktop：

   将服务器作为 Claude Desktop 应用程序安装：

   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 池/对数据。

工具

1. 获取代币的所有池/对：

   def get_token_pools(token_address: str) -> str:
   

   • 描述：查询给定代币地址的所有 Uniswap V2、V3 和 V4 池/对。

   • 参数：

     • token_address (str)：代币的以太坊地址（例如，USDC 的 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48）。

   • 输出：带有列：版本、ID、配对、费用等级、美元交易量、流动性/储备美元、费用美元的 Markdown 表格。

   • 示例：

     提示：

     获取地址为 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 的代币的 Uniswap 池
     

     输出：

     | 版本 | 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   |
     

2. 根据版本和 ID 获取特定池/对：

   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）。

   • 输出：带有详细信息：版本、ID、配对、Token0 地址、Token1 地址、费用等级、美元交易量、流动性/储备美元、费用美元的 Markdown 文本。

   • 示例：

     提示：

     根据 ID 0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc 获取 Uniswap V2 池数据
     

     输出：

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

许可证

该项目在 MIT 许可证下发布。详见 LICENSE 文件。