Uniswap Trader MCP

一个用于 AI 代理的 MCP 服务器，用于自动化在多个区块链上的 Uniswap DEX 上进行 Token 交换。

特性

• 价格报价: 获取 Token 交换的实时价格报价，并进行多跳路由优化。
• 交换执行: 在 Uniswap V3 上执行交换，具有可配置的滑点容忍度和截止时间。
• 交换建议: 基于流动性、费用和最佳路径生成交易建议。
• 多链支持: 兼容 Ethereum、Optimism、Polygon、Arbitrum、Celo、BNB Chain、Avalanche 和 Base。

前提条件

• Node.js: 14.x 或更高版本。
• npm: 用于包管理。
• 钱包: 一个有资金的钱包，带有用于执行交换的私钥。
• RPC 端点: 访问受支持链的区块链 RPC URL（例如，Infura、Alchemy）。

安装

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": "你的 Infura 密钥",
        "WALLET_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: 数字 (默认: 1)
• tokenIn: 字符串 (例如, "NATIVE" 或 Token 地址)
• tokenOut: 字符串 (例如, "NATIVE" 或 Token 地址)
• amountIn: 字符串 (可选, "exactIn" 时必需)
• amountOut: 字符串 (可选, "exactOut" 时必需)
• tradeType: "exactIn" 或 "exactOut" (默认: "exactIn")

示例提示:

获取在 Ethereum 上将 1 ETH 交换为 DAI 的价格报价。

输出:

{
  "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: 数字 (默认: 1)
• tokenIn: 字符串
• tokenOut: 字符串
• amountIn: 字符串 (可选, "exactIn" 时必需)
• amountOut: 字符串 (可选, "exactOut" 时必需)
• tradeType: "exactIn" 或 "exactOut" (默认: "exactIn")
• slippageTolerance: 数字 (默认: 0.5, 以百分比表示)
• deadline: 数字 (默认: 20, 以分钟为单位)

示例提示:

在 Ethereum 上将 1 ETH 交换为 DAI，滑点容忍度为 0.5%，截止时间为 20 分钟。

输出:

{
  "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。