Capsule Bash MCP

AIエージェントが安全で永続的なサンドボックス環境でbashコマンドを実行できるようにするMCPサーバーです。

仕組み

各セッションはWebAssemblyサンドボックス内で実行されます。サンドボックスは以下を提供します：

• 永続的な状態: セッション内のコマンド間で、作業ディレクトリ（cwd）、環境変数、ファイルシステムの変更が保持されます

• ファイルシステムの差分: すべての run レスポンスには、ディスク上で何が変更されたかの差分が含まれます

• 分離されたメモリ: 各セッションは独自のメモリアドレス空間を持ち、セッション間での漏洩はありません

• ホストへのアクセス不可: サンドボックスはホストのファイルシステムやネットワークにアクセスできません

詳細は Capsule Bash を参照してください。

ツール

セッション

同じ session_id 内のコマンドは、呼び出し間でcwd、環境変数、ファイルシステムの状態を共有します。

例

AIエージェントに次のように尋ねてください：

「数値のリストの平均を計算するPythonスクリプトを書いてください。」

エージェントは run を順番に呼び出します：

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

各呼び出しは stdout、stderr、exitCode、ファイルシステムの diff、および更新された state を返し、コンテキストを充実させ、会話履歴にトレースを残します。

セットアップ

MCPクライアントの設定（Claude Desktop、Cursorなど）に追加してください：

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

制限事項

• すべてのbashコマンドとオプションが実装されているわけではありません。コマンドが不足している場合や予期しない動作をする場合は、お気軽に issueを作成 してください。