Servidor MCP de comando remoto

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite la ejecución remota de comandos en diferentes sistemas operativos. Este servidor proporciona una interfaz unificada para ejecutar comandos de shell, gestionando automáticamente las diferencias específicas de la plataforma entre Windows y sistemas similares a Unix.

Características

Ejecución de comandos multiplataforma
Normalización automática de comandos entre Windows y Unix
Manejo de errores integrado y transmisión de salida
Compatibilidad con especificaciones de directorios de trabajo
Selección de shell específica de la plataforma

Instalación

Clonar el repositorio:

git clone https://github.com/deepsuthar496/Remote-Command-MCP
cd remote-command-server

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Configure el servidor MCP en su archivo de configuración:

Para la extensión Cline de VSCode ( cline_mcp_settings.json ):

{
  "mcpServers": {
    "remote-command": {
      "command": "node",
      "args": ["path/to/remote-command-server/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Uso

El servidor proporciona una única herramienta llamada execute_remote_command que puede ejecutar cualquier comando de shell válido en el host. Esto incluye:

Comandos del sistema
Comandos del administrador de paquetes (apt, yum, chocolatey, etc.)
Herramientas de desarrollo (git, npm, python, etc.)
Operaciones con archivos
Comandos de red
Gestión de servicios
Y cualquier otro comando CLI disponible en el sistema

Herramienta: execute_remote_command

Parámetros:

command (obligatorio): cualquier comando de shell válido que pueda ejecutarse en el sistema operativo host
cwd (opcional): Directorio de trabajo para la ejecución de comandos

Ejemplos

Información del sistema:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "systeminfo"  // Windows
  // or "uname -a"        // Linux
}
</arguments>
</use_mcp_tool>

Gestión de paquetes:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "npm list -g --depth=0"  // List global NPM packages
}
</arguments>
</use_mcp_tool>

Operaciones de red:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "netstat -an"  // Show all network connections
}
</arguments>
</use_mcp_tool>

Operaciones de Git:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "git status",
  "cwd": "/path/to/repo"
}
</arguments>
</use_mcp_tool>

Operaciones de archivo:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "ls -la",  // List files with details
  "cwd": "/path/to/directory"
}
</arguments>
</use_mcp_tool>

Gestión de procesos:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "ps aux"  // List all running processes (Unix)
  // or "tasklist"     // Windows equivalent
}
</arguments>
</use_mcp_tool>

Control de servicio:

<use_mcp_tool>
<server_name>remote-command</server_name>
<tool_name>execute_remote_command</tool_name>
<arguments>
{
  "command": "systemctl status nginx"  // Check service status (Linux)
  // or "sc query nginx"               // Windows equivalent
}
</arguments>
</use_mcp_tool>

Consideraciones de seguridad

Dado que este servidor puede ejecutar cualquier comando del sistema, tenga en cuenta las siguientes prácticas de seguridad:

Control de acceso : limite el acceso al servidor MCP únicamente a usuarios de confianza
Validación de comandos : valide los comandos antes de su ejecución en la lógica de su aplicación
Directorio de trabajo : utilice el parámetro cwd para restringir la ejecución de comandos a directorios específicos
Entorno : Tenga cuidado con los comandos que modifican la configuración del sistema o archivos confidenciales.
Permisos : Ejecute el servidor MCP con los permisos de usuario adecuados

Manejo de comandos multiplataforma

El servidor gestiona automáticamente las diferencias específicas de cada plataforma:

Traducción de comandos:
- ls ⟷ dir (convertido automáticamente según la plataforma)
- Formato adecuado del operador de tubería para cada plataforma
Selección de conchas:
- Windows: utiliza cmd.exe
- Unix/Linux: utiliza /bin/sh

Manejo de errores

El servidor proporciona mensajes de error detallados e incluye tanto la salida estándar como la salida estándar en la respuesta. Si un comando falla, recibirá un mensaje de error con detalles sobre el problema.

Ejemplo de respuesta de error:

{
  "content": [
    {
      "type": "text",
      "text": "Command execution error: Command failed with exit code 1"
    }
  ],
  "isError": true
}

Desarrollo

Estructura del proyecto

remote-command-server/
├── src/
│   └── index.ts    # Main server implementation
├── package.json
├── tsconfig.json
└── README.md

Edificio

npm run build

Esto compilará el código TypeScript y creará el ejecutable en el directorio build .

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Remote Command MCP Server

Integrations