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
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
- 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.
- El servidor se iniciará y proporcionará salida en stderr (para evitar interferir con la comunicación MCP en stdout)
- 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" }
- Parámetros:
start_tunnel
: crea un túnel web para acceder a la interfaz de la máquina virtual- Parámetros:
{ "port": 8080, "subdomain": "optional-subdomain" }
- Parámetros:
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
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Un servidor MCP simple que permite acceder y ejecutar comandos de shell en una máquina virtual a través de una interfaz de terminal basada en web, con tunelización automática para hacer que la máquina virtual sea accesible desde cualquier lugar.
Related MCP Servers
- -securityFlicense-qualityA simple MCP server that allows running terminal commands with output capture, enabling command execution on the host system from MCP-compatible clients like Claude Desktop.Last updated -1Python
- AsecurityAlicenseAqualityA server that enables secure interaction with remote SSH hosts through standardized MCP interface, providing functions like listing hosts, executing commands, and transferring files using native SSH tools.Last updated -73713JavaScriptMIT License
- -securityFlicense-qualityA unified remote terminal management server that simplifies complex SSH connections and server management through MCP protocol, allowing users to control multiple remote servers with natural language commands as easily as local operations.Last updated -133Python
- -securityFlicense-qualityA simple MCP server that provides a terminal tool for executing shell commands with safety features like timeouts and error handling.Last updated -Python