Capsule Bash MCP

一个 MCP 服务器，使您的 AI 智能体能够在安全、持久、沙盒化的环境中运行 bash 命令。

工作原理

每个会话都在 WebAssembly 沙盒内运行。沙盒提供：

• 持久化状态：工作目录 (cwd)、环境变量和文件系统更改在会话内的命令之间保持持久

• 文件系统差异：每次 run 响应都包含磁盘更改的差异 (diff)

• 内存隔离：每个会话都有自己的地址空间，不会发生跨会话泄漏

• 无主机访问：沙盒无法访问您的主机文件系统或网络

了解更多关于 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。