跳到正文
Ephemeral Sandbox mascot — a Siamese kitten peeking out of its wooden sandbox
浏览文档

接口

MCP 服务器

为每个 MCP 服务器注册管理、运行时或可观测性目录之一。

本页内容+

选择工具集

sandbox-mcp 在每个 stdio 进程中只投射一个固定语义目录。没有组合工具集，也没有组合式 sandbox mcp 命令。

管理工具

sandbox-mcp --set management

用于发现、生命周期、压缩和导出的八项工具。

打开工具参考

运行时工具

sandbox-mcp --set runtime

用于命令会话、文件和归因的七项工具。

打开工具参考

可观测性工具

sandbox-mcp --set observability

用于健康状态、遥测、资源和层的五项只读工具。

打开工具参考

构建与注册

构建一个可执行文件，然后使用绝对路径注册三个名称彼此独立的服务器进程。

Shell
cargo build -p sandbox-mcp --bin sandbox-mcp
MCP 客户端配置
{
  "mcpServers": {
    "ephemeral-os-management": {
      "command": "/absolute/path/to/target/debug/sandbox-mcp",
      "args": ["--set", "management"]
    },
    "ephemeral-os-runtime": {
      "command": "/absolute/path/to/target/debug/sandbox-mcp",
      "args": ["--set", "runtime"]
    },
    "ephemeral-os-observability": {
      "command": "/absolute/path/to/target/debug/sandbox-mcp",
      "args": ["--set", "observability"]
    }
  }
}

静态配置还必须通过进程环境或显式参数提供网关认证。下面的仓库辅助脚本会安装用于加载令牌的启动器，而不是把凭据写进 JSON。

Codex 设置

bin/setup-codex-mcp 会验证 Codex 和 Cargo，创建或校验共享令牌，构建服务器，替换名为 ephemeral-os-management、ephemeral-os-runtime 和 ephemeral-os-observability 的注册项，然后列出它们。

Shell
bin/setup-codex-mcp

注册后请重启 Codex 或打开新会话，以便发现工具定义。

stdio 与协议

客户端把 sandbox-mcp 启动为长期运行的 stdio 子进程。不要向该协议流写入诊断文本。服务器报告 MCP 协议版本 2025-06-18，并且只公布 tools 能力。

已实现的 MCP 接口

初始化、initialized 通知、ping、工具列表和工具调用。Prompts、resources、templates 和 completion 返回 method-not-found。

Schema 与结果

工具定义与 CLI 帮助来自同一份类型化目录。输入 schema 拒绝额外属性，并发布 sandbox_id、workspace_session_id 和 yield_time_ms 等语义属性名。

CallToolResult 结构
{
  "content": [],
  "structuredContent": { "images": ["ubuntu:24.04"] },
  "isError": false
}

详细页面会在每项工具旁显示实际发布的 schema，并标出处理器校验比生成的 JSON Schema 更严格之处。

错误与进度

本地请求构建错误、网关传输失败和网关错误 envelope 都会变成 isError: true 的工具结果。结构化错误 envelope 保留在 structuredContent 中。当前服务器不发送 MCP 进度通知；请使用操作结果和后续可观测性调用。

公开边界

内部工作区生命周期、捕获、重新挂载、层栈导出和导出分块操作都不是 MCP 工具。file_list 是有意保留的 daemon HTTP-only 例外。集成目录外的接口前，请参阅操作参考和Web 控制台边界。

18 个结果