Uniswap Trader MCP

Uniswap Trader MCP

用于 AI Agent 在多个区块链上自动执行 Uniswap DEX 代币兑换的 MCP 服务。

功能

• 价格报价：获取代币兑换的实时价格报价，并优化多跳路径。
• 执行兑换：在 Uniswap V3 上执行兑换，可配置滑点容差和截止时间。
• 兑换建议：根据流动性、费用和最优路径生成交易建议。
• 多链支持：兼容 Ethereum、Optimism、Polygon、Arbitrum、Celo、BNB Chain、Avalanche 和 Base。

前提条件

• Node.js：版本 14.x 或更高版本。
• npm：用于包管理。
• 钱包：已注资且含有私钥的钱包，用于执行兑换。
• RPC 端点：可访问受支持链的区块链 RPC URL（例如 Infura、Alchemy）。

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 Uniswap Trader MCP：

npx -y @smithery/cli install @kukapay/uniswap-trader-mcp --client claude

手动安装

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

配置

{
  "mcpServers": {
    "Uniswap-Trader-MCP": {
      "command": "node",
      "args": ["path/to/uniswap-trader-mcp/server/index.js"],
      "env": {
        "INFURA_KEY": "your infura key",
        "WALLET_PRIVATE_KEY": "your private key"
      }
    }
  }
}

用法

支持的链

支持以下区块链。请确保在 chainConfigs.js 中为每条链配置有效的 RPC URL、WETH 地址和 SwapRouter 地址。

链 ID	名称	说明
1	Ethereum	主网，广泛用于 Uniswap 交易
10	Optimism	Layer 2，需要 Optimism RPC
137	Polygon	速度快且成本低，原生代币为 MATIC
42161	Arbitrum	Layer 2，Arbitrum One 网络
42220	Celo	移动优先的区块链，使用 CELO
56	BNB Chain	Binance Smart Chain，使用 BNB
43114	Avalanche	高吞吐量，使用 AVAX
8453	Base	Coinbase 的 Layer 2，构建于 Optimism 之上

工具和提示词

1. getPrice

获取 Uniswap 兑换的价格报价。

Schema：

• chainId：Number（默认值：1）
• tokenIn：String（例如 "NATIVE" 或代币地址）
• tokenOut：String（例如 "NATIVE" 或代币地址）
• amountIn：String（可选，"exactIn" 时必需）
• amountOut：String（可选，"exactOut" 时必需）
• tradeType："exactIn" 或 "exactOut"（默认值："exactIn"）

提示词示例：

Get me a price quote for swapping 1 ETH to DAI on Ethereum.

输出：

{
  "chainId": 1,
  "tradeType": "exactIn",
  "price": "3000.50",
  "inputAmount": "1.000000",
  "outputAmount": "3000.50",
  "minimumReceived": "2985.50",
  "maximumInput": "1.005000",
  "route": [
    {
      "tokenIn": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "tokenOut": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "fee": 3000
    }
  ],
  "estimatedGas": "150000"
}

2. executeSwap

在 Uniswap 上执行兑换。

Schema：

• chainId：Number（默认值：1）
• tokenIn：String
• tokenOut：String
• amountIn：String（可选，"exactIn" 时必需）
• amountOut：String（可选，"exactOut" 时必需）
• tradeType："exactIn" 或 "exactOut"（默认值："exactIn"）
• slippageTolerance：Number（默认值：0.5，单位为百分比）
• deadline：Number（默认值：20，单位为分钟）

提示词示例：

Swap 1 ETH for DAI on Ethereum with a 0.5% slippage tolerance and a 20-minute deadline.

输出：

{
  "chainId": 1,
  "txHash": "0x1234...abcd",
  "tradeType": "exactIn",
  "amountIn": "1.000000",
  "outputAmount": "2990.75",
  "minimumReceived": "2985.50",
  "maximumInput": "1.005000",
  "fromToken": "NATIVE",
  "toToken": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
  "route": [
    {
      "tokenIn": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
      "tokenOut": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "fee": 3000
    }
  ],
  "gasUsed": "145000"
}

许可证

MIT License。详情请参阅 LICENSE。