Skip to main content
Glama
Capsule Bash Server

Capsule Bash Server

Official
by capsulerun

Capsule Bash MCP

MCP Server

Ein MCP-Server, der deinem KI-Agenten die Möglichkeit gibt, Bash-Befehle in einer sicheren, persistenten und isolierten Sandbox-Umgebung auszuführen.

Funktionsweise

Jede Sitzung läuft innerhalb einer WebAssembly-Sandbox. Die Sandbox bietet:

  • Persistenter Status: cwd, Umgebungsvariablen und Dateisystemänderungen bleiben über Befehle hinweg innerhalb einer Sitzung erhalten

  • Dateisystem-Diff: jede run-Antwort enthält ein Diff der Änderungen auf der Festplatte

  • Isolierter Speicher: jede Sitzung erhält ihren eigenen Adressraum, kein Datenaustausch zwischen Sitzungen

  • Kein Host-Zugriff: die Sandbox kann nicht auf dein Host-Dateisystem oder Netzwerk zugreifen

Erfahre mehr über Capsule Bash.

Related MCP server: execkit-mcp

Tools

Tool

Beschreibung

run

Führt einen Bash-Befehl in einer Sandbox-Sitzung aus. Gibt stdout, stderr, Exit-Code, Dateisystem-Diff und den aktuellen Status (cwd + env) zurück.

reset

Setzt das Dateisystem und den Status (cwd, Umgebungsvariablen) einer Sitzung auf ihre Anfangswerte zurück.

sessions

Listet alle aktiven Sitzungen auf.

Sitzungen

Befehle innerhalb derselben session_id teilen sich cwd, Umgebungsvariablen und den Dateisystemstatus über Aufrufe hinweg.

Beispiel

Frage deinen KI-Agenten:

"Schreibe ein Python-Skript, das den Durchschnitt einer Liste von Zahlen berechnet."

Der Agent ruft run nacheinander auf:

{ "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" }

Jeder Aufruf gibt stdout, stderr, exitCode, ein Dateisystem-diff und den aktualisierten state zurück, um den Kontext zu bereichern und die Nachverfolgung im Gesprächsverlauf zu gewährleisten.

Einrichtung

Füge dies zu deiner MCP-Client-Konfiguration hinzu (z. B. Claude Desktop, Cursor):

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

Einschränkungen

  • Nicht alle Bash-Befehle und -Optionen sind implementiert. Fühle dich frei, ein Issue zu öffnen, falls ein Befehl fehlt oder sich unerwartet verhält.

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