PermShell MCP

PermShell MCP

Un servidor de Model Context Protocol (MCP) para ejecutar comandos de shell con notificaciones de permisos.

Características

• Ejecuta comandos de shell con permisos explícitos mediante notificaciones de growl
• Construido sobre el Model Context Protocol para herramientas estandarizadas de LLM
• Múltiples salvaguardas para prevenir la ejecución no autorizada de comandos
• Diálogo de permisos transparente que muestra exactamente qué comandos se ejecutarán

Instalación

# Clone the repository
git clone https://github.com/yourusername/perm-shell-mcp.git
cd perm-shell-mcp

# Install dependencies
npm install

# Build the project
npm run build

Uso

Como herramienta independiente

# Start the server directly
npm start

Con Claude Desktop

Agrega la siguiente configuración a tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "permshell": {
      "command": "node",
      "args": ["/path/to/perm-shell-mcp/dist/index.js"]
    }
  }
}

Herramientas disponibles

execute-command

Ejecuta un comando de shell con permiso.

Ejemplo:

Can you list the files in my home directory?

system-info

Recupera información del sistema, incluyendo SO, tiempo de actividad, memoria, disco y CPU.

Ejemplo:

What's my system information?

Seguridad

• Todos los comandos requieren permiso explícito mediante notificaciones de escritorio
• Los comandos se muestran con su directorio de trabajo para total transparencia
• Los límites de tiempo de espera previenen procesos descontrolados
• La sanitización de entradas previene la inyección de comandos

Desarrollo

# Run in watch mode for development
npm run dev