Skip to main content
Glama
Capsule Bash Server

Capsule Bash Server

Official
by capsulerun

MCP de Bash Capsule

Servidor MCP

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.

Related MCP server: execkit-mcp

Herramientas

Herramienta

Descripción

run

Ejecuta un comando bash en una sesión aislada. Devuelve stdout, stderr, código de salida, diferencias del sistema de archivos y estado actual (cwd + env).

reset

Restablece el sistema de archivos y el estado (cwd, variables de entorno) de una sesión a sus valores iniciales.

sessions

Lista todas las sesiones activas.

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.

Available Tools

3 tools
resetA

Reset a session's filesystem and shell state (cwd, env vars) to their initial values. Useful to start fresh without creating a new session.

Inputs: session_id.

runB

Execute a Bash command in the sandboxed environment

Inputs: command (required), session_id.

sessionsA

List all active session IDs and their current state.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a unique, clear purpose: reset reverts state, run executes commands, and sessions lists active sessions. No ambiguity or overlap exists.

    Naming Consistency5/5

    All tool names are single, imperative verbs (reset, run, sessions) following a consistent, simple pattern.

    Tool Count5/5

    Three tools is well-scoped for a bash sandbox server, covering essential operations without superfluous or missing tools.

    Completeness4/5

    The set covers core actions (run, reset, list sessions) but lacks explicit session creation; likely sessions are created implicitly, leaving a minor gap.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers