local-only server

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

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

Haga clic en "+ Agregar servidor MCP" en Dive Desktop
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:

Dominio	Descripción	Argumentos permitidos
es	Listar el contenido del directorio	-l, -a, -h, -R, --ayuda, *
gato	Concatenar y mostrar el contenido del archivo	-n, -b, --ayuda, *
contraseña	Mostrar el directorio de trabajo actual	Ninguno
df	Mostrar el uso del disco	-h, -T, --ayuda
eco	Mostrar texto	Cualquier texto
PD	Mostrar el estado del proceso	-e, -f, -u, --ayuda
gratis	Mostrar el uso de la memoria	-h, -m, -g, --ayuda
tiempo de actividad	Mostrar el tiempo de actividad del sistema	Ninguno
fecha	Mostrar fecha y hora del sistema	+%Y-%m-%d, +%H:%M:%S, --ayuda
grep	Buscar patrones de texto en archivos	-i, -v, -n, -r, -l, --color, *
o	Mostrar quién está conectado y qué está haciendo	-h, -s, --no-header, --help
quién es	Consultar información de registro de dominio WHOIS	-H, *
encontrar	Buscar archivos en una jerarquía de directorios	-nombre, -tipo, -tamaño, -mtime, *
netstat	Información de conexión de red	-a, -n, -t, -u, -l, -p, --ayuda
lspci	Lista de dispositivos PCI	-v, -k, -mm, -nn, --ayuda
lsusb	Lista de dispositivos USB	-v, -t, -d, -s, --ayuda
excavar	Utilidad de búsqueda de DNS	+corto, +rastreo, +dnssec, @,
nslookup	Consultar registros DNS	-tipo=, -consulta=, *
IP	Mostrar dispositivos e interfaces de red	dirección, enlace, ruta, vecino, -br, *
dónde es	Localizar 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

Tools

View all tools

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.

Related Resources

Reddit Discussion about this server

Shell-MCP