Túnel MCP

Un servidor MCP (Protocolo de Contexto de Modelo) simple que permite acceder a la línea de comandos de una máquina virtual. Al iniciarse, también conecta el host a la web para que se pueda acceder a él mediante MCP.

Características

• Ejecutar comandos de shell en una máquina virtual a través de MCP

• Interfaz de terminal basada en web para la interacción con máquinas virtuales

• Túnel automático para que la máquina virtual sea accesible desde cualquier lugar

• Comunicación en tiempo real basada en WebSocket

Related MCP server: MCP SSH Agent

Prerrequisitos

• Node.js (v18 o más reciente)

Instalación y uso

Ejecutando con npx (sin instalación)

Instalación global

Desarrollo local

Desarrollo

Ejecute el servidor de desarrollo con recarga activa tanto para el backend como para el frontend:

Edificio

Construya tanto el frontend como el backend para producción:

Uso

1. Inicie el servidor MCP:

Esto compilará el proyecto e iniciará el servidor. Por defecto, se creará un túnel automáticamente. Use el indicador --no-tunnel para desactivar la tunelización automática.

2. El servidor se iniciará y proporcionará salida en stderr (para evitar interferir con la comunicación MCP en stdout)

3. Utilice MCP para interactuar con el servidor utilizando las siguientes herramientas:

Herramientas MCP disponibles

• execute_command : ejecuta un comando de shell en la máquina virtual

  • Parámetros: { "command": "your shell command" }

• start_tunnel : crea un túnel web para acceder a la interfaz de la máquina virtual

  • Parámetros: { "port": 8080, "subdomain": "optional-subdomain" }

Interfaz web

Tras iniciar el túnel, puede acceder a la interfaz web del terminal en la URL proporcionada por el túnel. Esta interfaz le permite:

• Ejecutar comandos directamente en la VM

• Vea las salidas de comando en tiempo real

• Interactúe con la VM desde cualquier dispositivo con acceso web

Variables de entorno

Cree un archivo .env para configurar el servidor:

Consideraciones de seguridad

Esta herramienta proporciona acceso directo a la línea de comandos de su máquina virtual. Tenga en cuenta estas prácticas de seguridad:

• Utilice mecanismos de autenticación fuertes antes de exponer el túnel

• Limite los comandos que se pueden ejecutar mediante una validación adecuada

• Considere correr en un entorno restringido

• No exponga información sensible a través del túnel