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

license - not found

quality - not tested

How are these scores calculated?

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

mcp-server-commands
g0t4
A
security
A
license
A
quality
An MCP server to run commands.
Last updated -
2
265
150
TypeScript
MIT License
Docker MCP Server
ckreiling
-
security
A
license
-
quality
An MCP server that allows managing Docker containers through natural language, enabling users to compose, introspect, and debug containers without running commands themselves.
Last updated -
468
Python
GPL 3.0
MCP Shell Server
diegofornalha
-
security
-
license
-
quality
A secure server that implements the Model Context Protocol (MCP) to enable controlled execution of authorized shell commands with stdin support.
Last updated -
Python
MCP Shell Server
mkusaka
A
security
A
license
A
quality
A server that uses the Model Context Protocol (MCP) to allow AI agents to safely execute shell commands on a host system.
Last updated -
1
76
2
TypeScript
MIT License

View all related MCP servers

MCP Tunnel