Uniswap Trader MCP

Uniswap Trader MCP

Un servidor MCP para que agentes de IA automaticen intercambios de tokens en Uniswap DEX a través de múltiples blockchains.

Características

• Cotizaciones de precios: Obtén cotizaciones de precios en tiempo real para intercambios de tokens con optimización de rutas de múltiples saltos.
• Ejecución de swaps: Ejecuta swaps en Uniswap V3 con tolerancia de deslizamiento y plazos configurables.
• Sugerencias de swaps: Genera sugerencias de trading basadas en liquidez, comisiones y rutas óptimas.
• Soporte multi-cadena: Compatible con Ethereum, Optimism, Polygon, Arbitrum, Celo, BNB Chain, Avalanche y Base.

Requisitos previos

• Node.js: Versión 14.x o superior.
• npm: Para la gestión de paquetes.
• Wallet: Una wallet con fondos y clave privada para ejecutar swaps.
• Endpoints RPC: Acceso a URLs RPC de blockchain (por ejemplo, Infura, Alchemy) para las cadenas soportadas.

Instalación

Instalación mediante Smithery

Para instalar Uniswap Trader MCP para Claude Desktop automáticamente mediante Smithery:

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

Instalación manual

1. Clonar el repositorio:

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

2. Instalar dependencias:

   npm install
   

Configuración

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

Uso

Cadenas soportadas

Las siguientes blockchains son compatibles. Asegúrate de que cada cadena esté configurada en chainConfigs.js con una URL RPC válida, dirección WETH y dirección SwapRouter.

ID de cadena	Nombre	Notas
1	Ethereum	Mainnet, ampliamente usado para trades de Uniswap
10	Optimism	Capa 2, requiere RPC de Optimism
137	Polygon	Rápido y de bajo costo, usa MATIC como nativo
42161	Arbitrum	Capa 2, red Arbitrum One
42220	Celo	Blockchain móvil primero, usa CELO
56	BNB Chain	Binance Smart Chain, usa BNB
43114	Avalanche	Alto rendimiento, usa AVAX
8453	Base	Capa 2 de Coinbase, construida sobre Optimism

Herramientas y Prompts

1. getPrice

Obtiene una cotización de precio para un swap de Uniswap.

Esquema:

• chainId: Número (por defecto: 1)
• tokenIn: Cadena (por ejemplo, "NATIVE" o dirección de token)
• tokenOut: Cadena (por ejemplo, "NATIVE" o dirección de token)
• amountIn: Cadena (opcional, requerido para "exactIn")
• amountOut: Cadena (opcional, requerido para "exactOut")
• tradeType: "exactIn" o "exactOut" (por defecto: "exactIn")

Ejemplo de prompt:

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

Salida:

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

Ejecuta un swap en Uniswap.

Esquema:

• chainId: Número (por defecto: 1)
• tokenIn: Cadena
• tokenOut: Cadena
• amountIn: Cadena (opcional, requerido para "exactIn")
• amountOut: Cadena (opcional, requerido para "exactOut")
• tradeType: "exactIn" o "exactOut" (por defecto: "exactIn")
• slippageTolerance: Número (por defecto: 0.5, en porcentaje)
• deadline: Número (por defecto: 20, en minutos)

Ejemplo de prompt:

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

Salida:

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

Licencia

Licencia MIT. Consulta LICENSE para más detalles.