Skip to main content
Glama

Shell-MCP

by kevinwatt

shell-mcp

Ejecución de comandos de shell en el servidor MCP

Una implementación de servidor MCP que proporciona capacidades de ejecución de comandos de shell seguro para LLM.

Características

  • Ejecución segura : solo comandos y argumentos incluidos en la lista blanca
  • Control de recursos : monitoreo del uso de memoria y CPU
  • Control de tiempo de espera : finalización automática de comandos de larga duración
  • Límites de tamaño : Restricciones de tamaño de salida por seguridad
  • Integración con MCP : funciona con Claude y otros LLM compatibles con MCP

Instalación

npm install @kevinwatt/shell-mcp

Configuración con Dive Desktop

  1. Haga clic en "+ Agregar servidor MCP" en Dive Desktop
  2. Copie y pegue esta configuración:
{ "mcpServers": { "shell": { "command": "npx", "args": [ "-y", "@kevinwatt/shell-mcp" ] } } }

Documentación de herramientas

  • shell_ls, shell_pwd, shell_df, etc.
    • Ejecutar comandos de shell incluidos en la lista blanca
    • Entradas:
      • command (cadena, obligatorio): Comando a ejecutar
      • args (matriz, opcional): argumentos del comando
      • timeout (número, opcional): tiempo de espera de ejecución en ms

Ejemplos de uso

Pídale a su LLM que:

"Show current directory using shell_pwd" "List files using shell_ls with -l argument" "Check disk usage using shell_df with -h argument"

Inicio manual

Si es necesario, inicie el servidor manualmente:

npx @kevinwatt/shell-mcp

Requisitos

  • Node.js 18+
  • Servicio LLM compatible con MCP

Desarrollo

# Install dependencies npm install # Watch mode npm run watch # Run tests npm test # Lint npm run lint

Licencia

MIT © Dewei Yen

Palabras clave

  • mcp
  • caparazón
  • dominio
  • claudio
  • LLM
  • automatización

Comandos disponibles

Los siguientes comandos de shell están disponibles:

DominioDescripciónArgumentos permitidos
esListar el contenido del directorio-l, -a, -h, -R, --ayuda, *
gatoConcatenar y mostrar el contenido del archivo-n, -b, --ayuda, *
contraseñaMostrar el directorio de trabajo actualNinguno
dfMostrar el uso del disco-h, -T, --ayuda
ecoMostrar textoCualquier texto
PDMostrar el estado del proceso-e, -f, -u, --ayuda
gratisMostrar el uso de la memoria-h, -m, -g, --ayuda
tiempo de actividadMostrar el tiempo de actividad del sistemaNinguno
fechaMostrar fecha y hora del sistema+%Y-%m-%d, +%H:%M:%S, --ayuda
grepBuscar patrones de texto en archivos-i, -v, -n, -r, -l, --color, *
oMostrar quién está conectado y qué está haciendo-h, -s, --no-header, --help
quién esConsultar información de registro de dominio WHOIS-H, *
encontrarBuscar archivos en una jerarquía de directorios-nombre, -tipo, -tamaño, -mtime, *
netstatInformación de conexión de red-a, -n, -t, -u, -l, -p, --ayuda
lspciLista de dispositivos PCI-v, -k, -mm, -nn, --ayuda
lsusbLista de dispositivos USB-v, -t, -d, -s, --ayuda
excavarUtilidad de búsqueda de DNS+corto, +rastreo, +dnssec, @*, *
nslookupConsultar registros DNS-tipo=*, -consulta=*, *
IPMostrar dispositivos e interfaces de reddirección, enlace, ruta, vecino, -br, *
dónde esLocalizar archivos binarios, fuente y manuales-b, -m, -s, *

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

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

Un servidor MCP seguro para ejecutar comandos de shell incluidos en la lista blanca con controles de recursos y tiempo de espera, diseñado para la integración con Claude y otros LLM compatibles con MCP.

  1. Características
    1. Instalación
      1. Configuración con Dive Desktop
        1. Documentación de herramientas
          1. Ejemplos de uso
            1. Inicio manual
              1. Requisitos
                1. Desarrollo
                  1. Licencia
                    1. Palabras clave
                      1. Comandos disponibles

                        Related MCP Servers

                        • 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
                          • Apple
                        • A
                          security
                          A
                          license
                          A
                          quality
                          An MCP server that enables secure terminal command execution, directory navigation, and file system operations through a standardized interface for LLMs.
                          Last updated -
                          10
                          23
                          Python
                          MIT License
                          • Apple
                        • -
                          security
                          F
                          license
                          -
                          quality
                          An MCP server that allows secure execution of macOS terminal commands through Claude or Roo Code with built-in security whitelisting and approval mechanisms.
                          Last updated -
                          1
                          JavaScript
                          • Apple
                        • -
                          security
                          A
                          license
                          -
                          quality
                          An MCP server that enables secure execution of shell commands across Windows, macOS, and Linux with built-in whitelisting and approval mechanisms for enhanced security.
                          Last updated -
                          13
                          JavaScript
                          MIT License
                          • Linux
                          • Apple

                        View all related MCP servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/kevinwatt/shell-mcp'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server