hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Supports configuration of the server through environment variables stored in a .env file.
Used for cloning the repository during local development setup.
Used as the runtime environment for the MCP server, with v18 or newer required for operation.

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)

npx mcp-cli

Instalación global

npm install -g mcp-cli
mcp-cli

Desarrollo local

# Clone repository
git clone [repository-url]
cd mcp-cli

# Install dependencies
npm install

Desarrollo

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

npm run dev

Edificio

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

npm run build-all

Uso

Inicie el servidor MCP:

# Start with automatic tunneling
npm start

# Start without automatic tunneling
npm start -- --no-tunnel

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" }
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:

# Server configuration
PORT=8080

# Localtunnel configuration
LOCALTUNNEL_SUBDOMAIN=your-preferred-subdomain

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

-

security - not tested

F

license - not found

-

quality - not tested

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.

MCP Tunnel