Back to MCP directory
publicPublicdnsLocal runtime

uniswap-trader-mcp

Uniswap Trader MCP是一个为AI代理设计的服务器,用于在多个区块链上自动化执行Uniswap代币交换。

article

README

🚀 Uniswap 交易者 MCP

Uniswap 交易者 MCP 是一个 MCP 服务器,专为 AI 代理打造,可自动执行跨多条链的 Uniswap DEX 代币交换,为用户提供便捷、高效的交易体验。

🚀 快速开始

在使用 Uniswap 交易者 MCP 之前,您需要满足一些先决条件,然后进行安装和配置。

先决条件

要使用此服务器,您需要以下内容:

  • Node.js 版本 14.0 或更高。
  • npm 包管理器。
  • 配置钱包和私钥以连接到不同的区块链网络。

安装

按照以下步骤安装 Uniswap 交易者 MCP:

  1. 克隆项目仓库:
    git clone https://github.com/your-repository.git
    cd uniswap-trader-mcp
    
  2. 安装依赖项:
    npm install
    
  3. 启动服务器:
    npm start
    

配置

将以下内容添加到 config.json 文件中以配置钱包和网络:

{
  "wallets": [
    {
      "network": "eth",
      "address": "0xYourEthAddress",
      "privateKey": "your-eth-private-key"
    },
    {
      "network": "bsc",
      "address": "0xYourBscAddress", 
      "privateKey": "your-bsc-private-key"
    }
  ],
  "supportedChains": ["eth", "bsc", "polygon", "arbitrum"]
}

✨ 主要特性

  • 价格查询:获取实时代币交换价格,支持多跳路径优化。
  • 交易执行:在 Uniswap V3 上执行交换,可配置滑点容忍度和截止时间。
  • 交易建议:根据流动性和费用生成最优路径的交易建议。
  • 多链支持:支持以下区块链网络:
    • Ethereum (ETH)
    • Binance Smart Chain (BSC)
    • Polygon Network
    • Arbitrum One

💻 使用示例

工具和提示

getPrice 命令

获取指定代币对的当前价格。

  • 输入参数
    • fromToken:源代币地址或名称(如 ETH)
    • toToken:目标代币地址或名称
  • 示例命令
    getPrice --fromToken "ETH" --toToken "DAI"
    
  • 输出结果
    {
      "chainId": 1,
      "price": 2000.5,
      "lastUpdated": "2024-03-15T12:34:56Z"
    }
    

executeSwap 命令

在指定区块链上执行代币交换。

  • 输入参数
    • fromToken:源代币地址或名称
    • toToken:目标代币地址
    • amount:要交换的源代币数量
    • slippageTolerance(可选):允许的滑点比例,默认为 0.5%
    • deadline(可选):交易的有效时间,以分钟为单位,默认为 20 分钟。
  • 示例命令
    executeSwap --fromToken "ETH" --toToken "DAI" --amount 1.0
    
  • 输出结果
    {
      "chainId": 1,
      "txHash": "0x123456789abcd...",
      "status": "success",
      "gasUsed": 145000
    }
    

📄 许可证

本项目采用 MIT 许可证。了解更多,请参阅 LICENSE

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client