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.

Related MCP server: jupiter-mcp

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 :

{
  "mcpServers": {
    "Jupiter-MCP": {
      "command": "node",
      "args": ["path/to/jupiter-mcp/server/index.js"],
      "env": {
        "SOLANA_RPC_URL": "solana rpc url you can access",
        "PRIVATE_KEY": "your private key"
      }
    }
  }
}

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.