return0 MCP Server

oficial

Depura tus aplicaciones remotas de Node.js y Next.js directamente desde tu IDE de IA como Cursor.

GitHub
1

Documentación

@return-0/mcp-server

Servidor MCP (Model Context Protocol) para return0 - una herramienta para depurar aplicaciones en producción en tiempo real.

Acerca de return0

return0 permite a los desarrolladores depurar aplicaciones Node.js en producción en tiempo real. Te permite monitorizar y solucionar problemas en tus aplicaciones conectándote a variables en vivo, observando el flujo de ejecución y comprendiendo el comportamiento en tiempo de ejecución directamente dentro del IDE de Cursor. Esto es especialmente potente para depurar aplicaciones en producción construidas con Next.js y desplegadas en plataformas como Vercel, donde los métodos de depuración tradicionales pueden ser desafiantes.

Chat Demo

Configuración en Cursor

Para usar este servidor MCP con el IDE de Cursor, necesitas configurarlo en los ajustes de Cursor. Primero, necesitarás obtener tu clave API de return0.

Obteniendo tu clave API

Para obtener tu clave API de return0, visita la documentación de return0. La documentación te guiará a través del proceso de obtención de tu clave API.

Una vez que tengas tu clave API, puedes configurar el servidor MCP de una de estas dos maneras:

Opción 1: Instalación en un clic

Haz clic en el botón de abajo para instalar y configurar automáticamente el servidor MCP de return0 en Cursor:

Add to Cursor

Esto configurará automáticamente el servidor MCP. Nota: Necesitarás añadir tu clave API de return0 a la configuración después de la instalación. Consulta la sección Obteniendo tu clave API arriba para instrucciones sobre cómo obtener tu clave API, y la sección de configuración manual abajo para detalles sobre cómo añadirla.

Opción 2: Configuración manual

Si prefieres configurar manualmente, sigue estos pasos en el IDE de Cursor:

  1. Abre el IDE de Cursor
  2. Ve a Ajustes (o Preferencias en macOS):
    • Haz clic en el icono del engranaje (⚙️) en la esquina inferior izquierda, o
    • Usa el atajo de teclado: Ctrl+, (Windows/Linux) o Cmd+, (macOS)
  3. En la barra de búsqueda de ajustes, escribe "MCP" o "Model Context Protocol"
  4. Haz clic en Servidores MCP o navega a la sección de configuración de MCP
  5. Haz clic en Añadir servidor o el botón + para añadir un nuevo servidor MCP
  6. Introduce la siguiente configuración:
    • Nombre: return0
    • Comando: npx
    • Args: -y, @return-0/mcp-server
    • Variables de entorno: Añade RETURN0_API_KEY con tu clave API como valor
  7. Haz clic en Guardar o Aplicar para guardar la configuración

La configuración debería verse así en tu archivo mcp.json:

{
  "mcpServers": {
    "return0": {
      "command": "npx",
      "args": ["-y", "@return-0/mcp-server"],
      "env": {
        "RETURN0_API_KEY": "your-api-key-here"
      }
    }
  }
}

Nota: Reemplaza "your-api-key-here" con tu clave API real de return0. Si aún no tienes una clave API, consulta la sección Obteniendo tu clave API arriba para instrucciones, o puedes usar "demo" para propósitos de prueba. El servidor MCP se instalará automáticamente a través de npx cuando Cursor se inicie.

Herramientas

Este servidor MCP proporciona una herramienta variable_extractor que puede ser utilizada por clientes compatibles con MCP.

Herramienta: variable_extractor

Extrae el valor en tiempo de ejecución, tipo y marca de tiempo de variables desde código en producción.

Esquema de entrada:

{
  files: Array<{
    fileName: string;        // Full absolute path to the file
    variables: Array<{
      name: string;          // Variable name to extract
      lineNumber: number;    // Line number where variable is defined
    }>
  }>
}

Ejemplo:

{
  "files": [
    {
      "fileName": "C:\\Users\\username\\project\\src\\app\\api\\route.ts",
      "variables": [
        {
          "name": "userData",
          "lineNumber": 42
        }
      ]
    }
  ]
}

Cómo funciona

  1. El servidor MCP recibe solicitudes para extraer valores de variables en tiempo de ejecución desde código en producción
  2. Lee los archivos fuente desde el sistema de archivos local
  3. Utiliza análisis AST de TypeScript para corregir números de línea y localizar variables con precisión
  4. Se conecta a la aplicación en producción en ejecución para recuperar valores de variables en vivo
  5. Devuelve los datos de extracción de variables corregidos con valores, tipos y marcas de tiempo en tiempo real

Licencia

Consulta el archivo LICENSE para más detalles.

Autor

return0

Enlaces