Jupiter MCP

Servidor MCP de Júpiter

Un servidor MCP para ejecutar intercambios de tokens en la cadena de bloques Solana utilizando la nueva API Ultra de Jupiter.

Características

• Obtenga órdenes de swap desde la API Ultra de Júpiter, combinando el enrutamiento DEX y RFQ (solicitud de cotización) para obtener precios óptimos.
• Ejecute swaps a través de la API Ultra de Júpiter, gestionando el deslizamiento, las tarifas de prioridad y el aterrizaje de transacciones.

Prerrequisitos

• Node.js : versión 18 o superior (para compatibilidad fetch nativa).
• Monedero Solana : una clave privada (codificada en base58) para firmar transacciones.
• Punto final de RPC : acceso a un nodo RPC de Solana (por ejemplo, https://api.mainnet-beta.solana.com ).

Instalación

1. Clonar el repositorio :
   git clone https://github.com/your-username/jupiter-mcp.git cd jupiter-mcp
2. Instalar dependencias : asegúrese de tener instalado el paquete del servidor MCP junto con otras dependencias necesarias:
   npm install
3. Configuración del cliente :

Herramientas

Herramientas Ultra API

• get-ultra-order :
  • Descripción : Obtiene una orden de intercambio de la API Ultra de Júpiter, aprovechando tanto el enrutamiento DEX como la RFQ para obtener un precio óptimo.
  • Entradas :
    • inputMint : Ingrese la dirección de acuñación del token (por ejemplo, SOL o clave pública del token).
    • outputMint : Dirección de acuñación del token de salida (por ejemplo, USDC o clave pública del token).
    • amount : Ingrese la cantidad como una cadena (por ejemplo, "1.23").
    • slippageBps : Tolerancia de deslizamiento en puntos básicos (por ejemplo, 50 para 0,5%).
  • Salida : JSON con requestId , transaction (codificada en base64), inputMint , outputMint , inAmount , outAmount , price .
• execute-ultra-order :
  • Descripción : Solicita a Júpiter que ejecute la transacción de intercambio en nombre del propietario de la billetera, manejando el deslizamiento, las tarifas de prioridad y el aterrizaje de la transacción.
  • Entradas :
    • requestId : Identificador único de get-ultra-order .
    • transaction : transacción codificada en Base64 de get-ultra-order .
  • Salida : JSON con status , transactionId , slot , inputAmountResult , outputAmountResult , swapEvents .

Ejemplo de interacción

A continuación se muestran ejemplos de interacción con el servidor utilizando indicaciones en lenguaje natural y respuestas esperadas:

Obtener una orden de intercambio

• Aviso : "Obtenga una orden de swap para intercambiar 1,23 SOL por USDC".
• Aporte :
  • Herramienta: get-ultra-order
  • Argumentos:
    • inputMint : "So11111111111111111111111111111111111111111112" (SOL)
    • outputMint : "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" (USDC)
    • amount : "1.23"
• Respuesta :
  { "requestId": "a770110b-82c9-46c8-ba61-09d955b27503", "transaction": "AQAAAA...base64-encoded-transaction...==", "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "inAmount": "1230000000", "outAmount": "19950000", "price": 0.01621951219512195 }

Ejecutar un swap

• Mensaje : "Ejecute la orden de intercambio con ID de solicitud 'a770110b-82c9-46c8-ba61-09d955b27503' utilizando la transacción proporcionada".
• Aporte :
  • Herramienta: execute-ultra-order
  • Argumentos:
    • requestId : "a770110b-82c9-46c8-ba61-09d955b27503"
    • transaction : "AQAAAA...transacción codificada en base64...=="
• Respuesta :
  { "status": "Success", "transactionId": "5x...solana-transaction-signature...", "slot": 299283763, "inputAmountResult": "1230000000", "outputAmountResult": "19950000", "swapEvents": [ { "type": "swap", "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "inAmount": "1230000000", "outAmount": "19950000" } ] }

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.