MCP de Bash Capsule

Un servidor MCP que proporciona a tu agente de IA la capacidad de ejecutar comandos bash en un entorno seguro, persistente y aislado (sandbox).

Cómo funciona

Cada sesión se ejecuta dentro de un entorno aislado de WebAssembly. El entorno proporciona:

• Estado persistente: el directorio de trabajo (cwd), las variables de entorno y los cambios en el sistema de archivos persisten entre comandos dentro de una sesión.

• Diferencias en el sistema de archivos: cada respuesta de run incluye una diferencia (diff) de lo que cambió en el disco.

• Memoria aislada: cada sesión obtiene su propio espacio de direcciones, sin fugas entre sesiones.

• Sin acceso al host: el entorno aislado no puede acceder a tu sistema de archivos ni a la red del host.

Obtén más información sobre Capsule Bash.

Herramientas

Sesiones

Los comandos dentro del mismo session_id comparten el directorio de trabajo, las variables de entorno y el estado del sistema de archivos entre llamadas.

Ejemplo

Pídele a tu agente de IA:

"Escribe un script de Python que calcule el promedio de una lista de números."

El agente llama a run secuencialmente:

{ "command": "mkdir -p /data && cd /data", "session_id": "custom_session" }
{ "command": "echo 'nums = [x for x in [1, 2, 3, []] if isinstance(x, int)]\nprint(sum(nums) / len(nums))' > avg.py", "session_id": "custom_session" }
{ "command": "python3 avg.py", "session_id": "custom_session" }

Cada llamada devuelve stdout, stderr, exitCode, un diff del sistema de archivos y el state actualizado para enriquecer el contexto y mantener el seguimiento en el historial de la conversación.

Configuración

Añádelo a la configuración de tu cliente MCP (por ejemplo, Claude Desktop, Cursor):

{
  "mcpServers": {
    "bash": {
      "command": "npx",
      "args": ["-y", "@capsule-run/bash-mcp"]
    }
  }
}

Limitaciones

• No todos los comandos y opciones de bash están implementados. No dudes en abrir una incidencia si falta un comando o se comporta de forma inesperada.