Capsule Bash MCP

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.

Tools

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.