Shell Command MCP Server

Shell Command MCP Server

Servidor Go que implementa el Protocolo de Contexto de Modelo (MCP) para ejecutar comandos de shell.

Características

• Ejecutar comandos de shell usando bash o zsh
• Listar ejecuciones de comandos anteriores
• Funciones de seguridad para limitar los comandos permitidos
• Configurar el conjunto de comandos permitidos por seguridad

Nota: El servidor solo permitirá la ejecución de comandos especificados mediante el parámetro allowedCommands o todos los comandos si se configura con "*".

API

Herramientas

• execute_command

  • Ejecutar un comando de shell
  • Entrada:
    • command (cadena): El comando a ejecutar
    • shell (cadena, opcional): El shell a usar (bash o zsh, por defecto bash)
  • Salida:
    • Salida del comando con stdout y stderr
    • Código de salida
    • Tiempo de ejecución

• list_recent_commands

  • Listar comandos ejecutados recientemente
  • Entrada:
    • limit (entero, opcional): Número de comandos a devolver (por defecto 10)
  • Salida:
    • Lista de comandos ejecutados recientemente con marcas de tiempo y estado

• list_allowed_commands

  • Listar todos los comandos que el servidor tiene permitido ejecutar
  • No requiere entrada
  • Devuelve:
    • Lista de comandos permitidos o "*" si todos los comandos están permitidos

Uso con Claude Desktop

Instalar el servidor

go install github.com/gamunu/mcp-unix-shell

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "shell": {
      "command": "mcp-unix-shell",
      "args": [
        "--allowed-commands=ls,cat,echo,find"
      ]
    }
  }
}

Para permitir todos los comandos (usar con precaución):

{
  "mcpServers": {
    "shell": {
      "command": "mcp-unix-shell",
      "args": [
        "--allowed-commands=*"
      ]
    }
  }
}

Consideraciones de Seguridad

Al usar este servidor MCP, ten en cuenta:

1. Solo permite comandos en los que confíes: se recomienda una lista de permitidos restrictiva
2. Evita permitir comandos que puedan modificar la configuración del sistema o acceder a datos sensibles
3. El servidor se ejecuta con los permisos del usuario que ejecuta Claude Desktop
4. La salida del comando se envía de vuelta al LLM, así que ten cuidado con la información sensible

Licencia

Este servidor MCP está licenciado bajo la Licencia Apache 2.0.