关于 box by Simular
box by Simular 为 AI Agent 提供云端 Linux 桌面,内含 Chrome 和 shell,并通过 MCP 控制。它适合需要委派电脑操作或编码任务、同时让本地电脑保持可用的用户;任务可实时查看并接管。
主要功能
- 01通过 MCP 控制云端 Linux 桌面
- 02在 box 中使用 Chrome 和 shell
- 03实时查看会话并接管操作
- 04将编码任务交给 box 会话
- 05带回提交记录和交接说明
适用场景
- 01让 Agent 代为执行浏览器和 shell 任务
- 02离开期间继续运行编码任务
- 03按需查看会话并接管
- 04将提交记录和书面交接带回本地任务
MCP 相关
https://mcp.box.simular.ai/mcp 上的 MCP 服务让 Agent 控制云端 Linux 桌面。面向不同 Agent 的插件和 CLI 包用于配置连接与登录。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.box.simular.ai/mcpclaude mcp add --transport http ai-simular-box https://mcp.box.simular.ai/mcp{"mcpServers":{"ai-simular-box":{"type":"http","url":"https://mcp.box.simular.ai/mcp"}}}在 Cursor 中打开{"servers":{"ai-simular-box":{"type":"http","url":"https://mcp.box.simular.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"ai-simular-box":{"type":"http","url":"https://mcp.box.simular.ai/mcp"}}}{"mcpServers":{"ai-simular-box":{"serverUrl":"https://mcp.box.simular.ai/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
box by Simular:插件
box 为你的 AI Agent 提供一台专属电脑:一台配备 Chrome 和 shell 的云端 Linux 桌面,Agent 可通过 MCP 操控它,同时你的电脑仍可正常使用。你可以在 https://box.simular.ai/box 实时观看并接管。
大多数 Agent 无需插件:添加 MCP 服务 https://mcp.box.simular.ai/mcp 并登录一次即可(参见 https://box.simular.ai/install)。此代码仓库为每种 Agent 提供一个按其自身方式安装 box 的软件包。每个文件夹均可独立使用,并通过对应 Agent 的渠道发布。
| Agent | 文件夹 | 登录方式 | 安装 |
|---|---|---|---|
| Claude Code 和 Cowork | claude/ | OAuth,在浏览器中登录一次 | /plugin marketplace add simular-ai/box-plugin,然后运行 /plugin install box@simular-box |
| DeepSeek Harness (dsh) | dsh/ | 个人密钥(cb_...),粘贴到 Plugins 中插件的页面 | dsh/README.md |
| OpenClaw | openclaw/ | OAuth,在 Settings 中插件页面登录一次 | openclaw plugins install @simular-ai/openclaw-box |
| Claude Code、Codex、Cursor、OpenCode、Gemini CLI、Hermes、OpenClaw、VS Code 均可使用(并提供 Claude Desktop 的操作步骤) | cli/ | OAuth;Hermes 和 OpenClaw 可通过 --auth key 使用个人密钥 | npx @simular-ai/box connect(通过 npx @simular-ai/box doctor 检查) |
| Hermes Agent | hermes/ | 在 MCP_BOX_API_KEY 中设置个人密钥(cb_...);OAuth 为可选项 | hermes/README.md |
| ChatGPT 和 Codex(OpenAI 插件目录) | openai/ | OAuth,在浏览器中登录一次 | OpenAI 审核通过后上架;使用 openai/build-zip.sh 构建上传包(openai/README.md) |
卸载任务:将编码任务移入 box,完成后再取回
要在任务进行到一半时离线?在带有插件的 Claude Code 中,/box:offload 会将任务交给 box 中一个全新的 Claude Code(或 Codex、Cursor)会话处理,你离开期间它会继续工作;/box:back 会将它的提交和写好的交接说明带回本地并进行合并。其他 Agent 或普通终端可使用 npx @simular-ai/box offload 和 npx @simular-ai/box back。设置和详情见:cli/README.md。
添加 Agent
添加一个以 Agent 命名的文件夹,其中包含独立的清单、MCP 配置,以及在 Agent 支持技能时附上一份 claude/skills/box/SKILL.md。将其指向 https://mcp.box.simular.ai/mcp。Agent 支持 OAuth 登录时使用 OAuth;否则,从环境变量或 Agent 自带的凭据存储中读取个人密钥,切勿将密钥存放在软件包中的文件里。然后在上方添加一行。
发布
claude/:更新claude/.claude-plugin/plugin.json中的version。Claude Code 不会自动更新第三方市场:用户可通过/plugin marketplace update simular-box和/plugin update box@simular-box更新,或运行npx @simular-ai/box connect。openclaw/:更新openclaw/package.json和openclaw/openclaw.plugin.json中的version,然后在openclaw/下运行npm run build和clawhub package publish .。dsh/:更新dsh/package.json中的version,然后推送标签dsh-vX.Y.Z。发布工作流会附上dsh-box.tgz。openai/:更新openai/plugin.json中的version和publication.release_notes,运行openai/build-zip.sh,并在 platform.openai.com/plugins 上传 ZIP。hermes/:更新hermes/plugin.json中的version。在 box 收录到 Hermes 插件目录之前,用户需要手动复制文件夹。- Claude 插件的 CLI 版本固定:自 1.0.0 起,npm 上的
@simular-ai/box是从 simular-ai/box-cli 发布的 Rust CLI。要让插件使用新的 CLI 版本,请在同一个 PR 中,将claude/skills/box-offload/SKILL.md中的精确版本固定npx -y @simular-ai/[email protected]改为新版本,并更新claude/.claude-plugin/plugin.json中的version(CI 会检查claude/下的所有版本固定是否指向同一个精确版本,且该版本是否已发布到 npm;不得使用版本范围,因为 Claude 目录审核要求实际运行的版本与审核时看到的版本一致)。 cli/:JavaScript CLI(0.2.x)。它不再发布到 npm:Rust 1.0.0 发布时,其在@simular-ai/box上的可信发布者已被移除,因此不要推送cli-v*标签。现在端点和 CLI 的更改都提交到 simular-ai/box-cli。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。