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)

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

execute-command

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

k8s-interactive-mcp
TaichiHo
A
security
F
license
A
quality
A MCP server that can run Kubernetes commands with a given kubeconfig path and provide interpretation of the commands.
Last updated -
1
2
JavaScript
Sandbox MCP Server
Tsuchijo
-
security
F
license
-
quality
Provides isolated Docker environments for code execution, enabling users to create and manage containers, execute multi-language code, save and reproduce development environments, ensuring security and isolation.
Last updated -
6
Python
mcp-shell-server
tumf
A
security
A
license
A
quality
A secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.
Last updated -
1
74
Python
MIT License
Docker MCP Server
suvarchal
-
security
F
license
-
quality
Allows 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 -
2
JavaScript

View all related MCP servers

Shell Command MCP Server