金大哥 - uniswap-pools-mcp MCP 详情

article

README

🚀 Uniswap Pools MCP

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

GitHub License

✨ 主要特性

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

📦 安装指南

前提条件

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

安装步骤

克隆仓库：

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

安装依赖项：
```
uv sync
```
安装到 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 文件。

uniswap-pools-mcp