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 文件。