Docker Sandboxes
说明列出 MCP 服务器
用法sbx mcp ls [flags]

描述 ​

列出提供这些服务的网关下已注册的 MCP 服务器。

GATEWAY 列说明每个服务器运行在哪里、由谁控制，以及登录身份； 每一行还会说明其传输方式以及当前是否可用。 需要授权的服务器会给出 'sbx mcp auth' 这一后续步骤。

注册时使用了自定义请求头的服务器会被标记出来；请求头占位符没有存储值的服务器 会给出 'sbx secret set' 这一后续步骤，而本网关无法发送其请求头的服务器 会被标记为不支持。无论哪种情况，该服务器目前都无法连接。 运行 'sbx mcp inspect <name>' 可以查看请求头本身 以及每个占位符的状态。

认证状态无需启动 OAuth 流程即可读取——在本地数据平面模式下从本地令牌存储读取， 否则从托管的控制平面读取。

使用 --cloud： 列出已有云端沙箱网关上报的 MCP 服务器，并附带引用每个服务器的沙箱。 被网关跳过的服务器不会包含在内。 这不是已配置服务器的完整清单：未使用的配置以及不上报服务器名称的网关 都不会出现，使用 --quiet 时也是如此。

指定一个沙箱可以显示其网关状态和主机、请求的服务器 以及被跳过的服务器。

选项 ​

选项默认值说明
--format输出格式：table、json 或 yaml
--json以 JSON 格式输出
-q, --quiet仅显示 MCP 服务器名称

全局选项 ​

选项默认值说明
--cloud改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表）
-D, --debug启用调试日志
--no-input从不提示；需要应答的命令会直接失败，并给出应当运行的命令

示例 ​

console
sbx mcp ls

# 输出便于脚本处理的机器可读结果
sbx mcp ls --json

# 云端：列出已有沙箱上报的服务器
sbx --cloud mcp ls

# 云端：按名称或 sbx_ ID 显示云端沙箱的网关
sbx --cloud mcp ls my-sbx

参见 ​