A
security-
licenseA
qualityA secure MCP server for executing whitelisted shell commands with resource and timeout controls, designed for integration with Claude and other MCP-compatible LLMs.
Last updated -
20
39
4
MIT License
Servidor MCP de comandos de Shell
Este es un servidor MCP (Protocolo de Contexto de Modelo) que permite ejecutar comandos de shell dentro de un contenedor Docker. Proporciona un espacio de trabajo seguro y aislado para ejecutar comandos sin dar acceso al demonio de Docker del host.
Características
Ejecute scripts de shell a través de una interfaz MCP simple
ejecución sincrónica
ejecución asincrónica con 4 modos diferentes
completar: notificar cuando se completa el comando
línea: notificar en cada línea de salida
fragmento: notificar en cada fragmento de salida
Carácter: notificar sobre cada carácter de salida.
Herramientas de Kubernetes incluidas: kubectl, helm, kustomize, hemfile
Entorno de contenedor Docker aislado con usuario no root
Se implementó la asignación de ID de usuario/ID de grupo entre el host y el contenedor. Esto permite que el contenedor se ejecute con el mismo usuario que el host, lo que garantiza que los archivos creados por el contenedor tengan la misma propiedad y los mismos permisos que los creados por el host.
Monta un directorio de host en el directorio /home/mcp del contenedor para persistencia. Se convierte en el directorio de inicio en el que trabaja la IA.
Si el directorio del host está vacío, los archivos iniciales se copiarán desde la copia de seguridad en el contenedor.
Filosofía del diseño
Este servidor MCP proporciona a la IA un espacio de trabajo similar al de un humano. La autorización no está limitada por las funciones de MCP, sino por el aislamiento del contenedor y las restricciones de autorización externa.
Proporciona herramientas más generales, como la ejecución de scripts de shell, para que puedan utilizarse sin conocimientos especializados sobre el uso de herramientas.
La implementación del servidor se mantiene lo más simple posible para facilitar la auditoría del código.
Empezando
Prerrequisitos
Estibador
Uso con Claude para escritorio
Agregue la siguiente configuración a su archivo de configuración de Claude for Desktop.
Sistema operativo Mac:
"shell-command": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--mount",
"type=bind,src=/Users/user-name/MCPHome,dst=/home/mcp",
"ghcr.io/kaznak/shell-command-mcp:latest"
]
}
Reemplace /Users/user-name/ClaudeWorks con el directorio que desea que esté disponible para el contenedor.
Ventanas:
"shell-command": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--mount",
"type=bind,src=\\\\wsl.localhost\\Ubuntu\\home\\user-name\\MCPHome,dst=/home/mcp",
"ghcr.io/kaznak/shell-command-mcp:latest"
]
}
Proporcionar algunas indicaciones
Para operar los archivos en el directorio montado.
Herramientas MCP disponibles
Consideraciones de seguridad
El servidor MCP se ejecuta como un usuario no root dentro del contenedor
El contenedor no tiene acceso al demonio Docker del host
El espacio de trabajo del usuario se monta desde el host para persistencia
Licencia
Instituto Tecnológico de Massachusetts (MIT)
local-only server
The server can only run on the client's local machine because it depends on local resources.
Permite ejecutar comandos de shell dentro de un contenedor Docker seguro a través de la interfaz MCP de Claude, proporcionando herramientas de Kubernetes y un entorno aislado sin acceso al demonio Docker del host.
- Características
- Filosofía del diseño
- Empezando
- Herramientas MCP disponibles
- Consideraciones de seguridad
- Licencia
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityAllows Claude and other AI assistants to interact with Docker through the MCP protocol, enabling container and image management including listing, running, stopping, and pulling Docker resources.Last updated -6314
- -security-license-qualityAn MCP server that provides secure access to Kali Linux cybersecurity tools through Claude's interface, enabling users to run Kali Linux commands directly from Claude Desktop.
- -security-license-qualityAn MCP server that enables Claude to execute bash commands on the host machine with configurable working directories and timeouts.