使用说明

大浅盘

你的电脑，放在盘子里。

暴露的MCP服务器阅读, 写, 编辑, Bash, 全局, grep，以及 JavaScript 通过Stdio和StreamableHTTP传输的工具。内置于包子，编译为独立的可执行文件。

设计用于基于浏览器（或任何MCP兼容）的代理，如哈德良，控制计算机。

工具

工具	说明
读	使用分页（偏移/限制）读取文件内容。检测图像文件（JPEG、PNG、GIF、WebP）并返回元数据。将文本截断为2000行或50KB。
写	创建或覆盖文件。自动创建父目录。
编辑	查找并替换为精确或模糊匹配（规范化智能引号、破折号和Unicode空格）。需要唯一匹配，或使用 `replace_all` 每次出现（仅精确匹配）。返回一个统一的diff
bash	执行带有可选超时的shell命令。输出截断为最后2000行或50KB。
通配符	快速文件模式匹配。最多返回500条与glob模式匹配的路径（例如。 `*/.ts`).
grep	使用搜索文件内容 ripgrep支持正则表达式、文件过滤、上下文行和多种输出模式。需要 `rg` 待安装。
JavaScript	在持久化Node.js中评估JavaScript/TypeScript `vm` 背景。状态在会话内的通话中持续存在。支持 `await`, `console.log`，并通过以下方式从unpkg.com加载包裹 `await load("package")`.Auto返回最后一个表达式。不是安全沙箱 --看安全在......下面

快速启动

从发布二进制文件

从以下网址下载适用于您平台的最新二进制文件发布，或抓住它 curl:

# Download (replace the filename for your platform)
# Available: platter-linux-x64, platter-linux-arm64, platter-darwin-x64, platter-darwin-arm64
curl -fsSL https://github.com/hadriangateway/platter/releases/latest/download/platter-linux-x64 -o platter
chmod +x platter

./platter          # stdio mode
./platter -t http  # HTTP mode on :3100

码头工人

docker run --rm -i ghcr.io/hadriangateway/platter                                   # stdio mode
docker run --rm -p 3100:3100 ghcr.io/hadriangateway/platter -t http --host 0.0.0.0  # HTTP mode

看码头工人下面介绍安装路径、网络、安装额外软件和构建自定义映像。

来源

bun install
bun run dev      # run directly from TypeScript
bun run compile  # build standalone binary for current platform

用法

platter v1.x.x

Your computer, served on a platter.

Usage: platter [options]

Options:
  -t, --transport <stdio|http>   Transport mode (default: stdio)
      --tray                     Run the HTTP server with a Linux system tray
                                 (implies --transport=http, persists state
                                 across restarts in ~/.config/platter)
  -p, --port <number>            HTTP port (default: 3100)
      --host <address>           HTTP bind address (default: 127.0.0.1)
      --cwd <path>               Working directory for tools (default: current directory)
      --cors-origin <origin>     Allowed CORS origin (default: *)
      --auth <mode>              Auth mode: oauth, bearer, jwks, none (default: oauth)
      --auth-token <token>       Bearer token for HTTP auth (auto-generated if omitted)
      --tls-cert <path>          TLS certificate file (PEM) — enables HTTPS
      --tls-key <path>           TLS private key file (PEM)

External JWKS / OIDC (--auth jwks — verify tokens from an external IdP):
      --oauth-issuer <url>       Issuer URL; OIDC-discovers the JWKS endpoint
      --jwks-url <url>           Explicit JWKS endpoint (overrides discovery)
      --oauth-audience <aud>     Expected token audience (strongly recommended)
      --jwks-scope-grants        Map tools:<name> token scopes to tool access
                                 (fail closed: a token with no tools:<name>
                                 scopes is granted no tools)

Process management:
      --max-processes <number>   Max concurrent bash processes per session (default: 20)
      --max-sessions <number>    Max concurrent HTTP sessions (default: unlimited)

Restrictions:
      --tools <list>             Comma-separated tools to enable (default: all)
                                 Valid: read, write, edit, bash, glob, grep, js
      --allow-path <path>        Restrict read/write/edit/glob/grep to this path (repeatable)
                                 Does not restrict bash or js
      --allow-command <regex>    Allow bash commands matching this pattern (repeatable)
                                 Pattern must match the entire command string
                                 Applies to bash only; does not restrict js

Sandbox (applies to bash only; the js tool is never sandboxed):
      --sandbox                  Use just-bash sandbox instead of native bash
      --sandbox-fs <mode>        Filesystem backend: memory, overlay, readwrite (default: readwrite)
      --sandbox-allow-url <url>  Allow network access to URL prefix (repeatable)

  -h, --help                     Show this help message
  -v, --version                  Show version number

限制

您可以限制注册的工具、文件工具可以访问的文件系统路径以及bash工具可以执行的命令。

工具选择

仅注册特定工具。未注册的工具对MCP客户端完全隐藏：

platter --tools read,glob,grep    # read-only server
platter --tools read,write,edit   # no bash/search/js

路径限制

将文件访问工具（读、写、编辑、glob、grep）限制为一个或多个目录树。路径解析为绝对形式，符号链接解析为 realpath 为防止逃逸：

platter --allow-path /home/user/project
platter --allow-path /home/user/project --allow-path /tmp

命令限制

只允许bash命令整个命令字符串至少匹配一个正则表达式模式：

platter --allow-command "git( .*)?"                             # git only
platter --allow-command "git( .*)?" --allow-command "npm( .*)?" # git or npm
platter --allow-command "ls( .*)?" --allow-command "cat .*"     # ls or cat

模式被锚定： --allow-command "git( .*)?" 编译到 ^(?:git( .*)?)$，所以 git status 比赛，但 rm -rf / && git status 没有。

组合示例

# Locked-down: read-only tools, scoped to one directory
platter --tools read,glob,grep --allow-path /home/user/project

# Full tools, but bash restricted to git/npm, files restricted to project
platter --allow-path ./my-project --allow-command "git( .*)?" --allow-command "npm( .*)?"

活动限制在启动时记录到stderr。

认证

被控制 --auth <mode>:

模式	描述
`oauth` （默认）	OAuth 2.1授权码+PKCE，静态承载令牌作为回退
`bearer`	仅限静态承载令牌
`jwks`	资源服务器模式：通过JWKS验证由外部OAuth/OIDC颁发者（Auth0、Keycloak、Okta、Entra）颁发的JWT访问令牌
`none`	无身份验证

OAuth 2.1(`--auth oauth`)

支持的MCP客户端 RFC 9728 （受保护的资源元数据）可以自动发现盘片的OAuth端点并进行身份验证，而无需手动复制令牌。

流程：

客户端发现 /.well-known/oauth-authorization-server 和 /.well-known/oauth-protected-resource/mcp
客户通过以下方式注册 POST /register (RFC 7591 动态客户端注册）
客户端通过以下方式启动授权码+PKCE流 /authorize
A. 验证码 带外显示（打印到stderr，或在托盘模式下显示为桌面通知）
用户看到同意页面，输入确认码，选择要授予的工具，并批准或拒绝请求
客户端在以下地址交换令牌的授权码 /token
后续请求使用 Authorization: Bearer <access_token>

确认码证明批准请求的人可以访问盘片进程——没有它，可以到达同意页面的远程攻击者就无法批准。代码是一次性的，5分钟后过期，最多尝试5次。

访问令牌在1小时后过期，可以刷新。客户端注册将保留到 ~/.config/platter/clients.json静态承载令牌也被接受为不支持OAuth的客户端的后备方案。

持有者代币(`--auth bearer`)

随机承载令牌在启动时生成并打印到stderr（或以托盘模式存储在系统密钥环中）。每个请求必须包括 Authorization: Bearer <token>。您可以提供自己的：

platter -t http --auth bearer --auth-token my-secret-token

无身份验证(`--auth none`)

完全禁用身份验证（例如，在处理身份验证的反向代理后面）：

platter -t http --auth none

外部JWKS/OIDC(`--auth jwks`)

在 jwks 模式盘片充当纯粹的 资源服务器：它不铸造自己的代币。相反，它验证由以下人员颁发的JWT访问令牌外部 OAuth/OIDC授权服务器（Auth0、Keycloak、Okta、Microsoft Entra）——根据发卡机构的JWKS验证签名，以及 iss, aud，以及 exp 声称。这使您可以在没有反向代理的情况下将盘片放在现有的IdP后面。

# Auth0 (root issuer)
platter -t http --auth jwks \
  --oauth-issuer https://YOUR_TENANT.auth0.com/ \
  --oauth-audience https://platter.example.com/mcp

# Keycloak (realm issuer)
platter -t http --auth jwks \
  --oauth-issuer https://kc.example.com/realms/myrealm \
  --oauth-audience platter-api

# Skip discovery / point at a JWKS endpoint directly
platter -t http --auth jwks \
  --jwks-url https://idp.example.com/.well-known/jwks.json \
  --oauth-audience platter-api

受众验证（强烈推荐）。 集 --oauth-audience 到您的IdP中配置的API标识符。如果你忽略了它，拼盘接受任何来自发行者的有效令牌——包括为不同资源服务器铸造的令牌（混淆的代理风险）。当禁用受众验证时，plate会在启动时打印警告。

发现。 随着 --oauth-issuer，plate获取发行人的 /.well-known/openid-configuration （回到 /.well-known/oauth-authorization-server)在启动时找到 jwks_uri 并将授权服务器重新通告给支持RFC 9728的MCP客户端（在 /.well-known/oauth-protected-resource/mcp).通过 --jwks-url 跳过发现，或者启动时无法访问IdP。如果发现失败，但 --jwks-url 设置后，令牌验证仍然有效——只跳过RFC 9728自动通告。

授权（令牌可以做什么）。 默认情况下，经过验证的令牌获得管理员级别的访问权限，仅受操作员CLI限制的约束(--tools, --allow-path, --allow-command, --sandbox)--IdP控件谁进入后，CLI会标记控件什么他们可以的。通过 --jwks-scope-grants 额外荣誉 tools:<name> 令牌中的作用域（例如。 tools:read tools:bash)，这进一步缩小了授予的工具（它们只能缩小，永远不会扩大操作员的上限）。这 scope 索赔和Entra风格 scp 这两项主张都得到了支持。在此模式下，访问是 故障关闭：带有“否”的令牌 tools:* 作用域根本没有被授予任何工具，因此令牌必须明确请求它需要的工具。

没有静态回退。 不像 oauth 模式， jwks 模式接受仅外部发布的JWT-- --auth-token 被拒绝。

注： MCP_DANGEROUSLY_ALLOW_INSECURE_ISSUER_URL 与此模式无关。它只涉及盘子的服务拥有通过http发送 --auth oauth 模式。外部 https 发行人不需要这样的标志。如果你指出 --auth jwks 在平原上-http 发行者（例如localhost Keycloak）发出警告并跳过RFC 9728元数据通告，但令牌验证仍然有效。

TLS（HTTPS）

要通过HTTPS提供服务，请提供PEM编码的证书和私钥：

platter -t http --tls-cert cert.pem --tls-key key.pem

两者 --tls-cert 和 --tls-key 需要一起。如果提供，服务器将通过HTTPS而不是普通HTTP进行监听。

要生成用于开发或受信任的内部使用的自签名证书，请执行以下操作：

openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -nodes -subj '/CN=myserver'
platter -t http --tls-cert cert.pem --tls-key key.pem

标准模式

用于生成子流程的Claude Desktop、Cursor和其他MCP客户端：

{
  "mcpServers": {
    "platter": {
      "command": "/path/to/platter"
    }
  }
}

HTTP模式（流式HTTP）

对于基于浏览器的代理和远程连接：

platter -t http -p 3100

服务器在以下位置公开了一个端点 /mcp 它处理：

POST /mcp -JSON-RPC消息（初始化、工具调用）
GET /mcp -SSE通知流
DELETE /mcp -会话拆除

默认情况下，所有来源都启用了CORS（反映了请求 Origin).要限制到特定的来源：

platter -t http --cors-origin https://myapp.example.com

会话通过 Mcp-Session-Id 根据StreamableHTTP规范的标头。

服务器验证 Host 标题以防止 DNS重新绑定攻击.何时 --cors-origin 已设置 Origin 标头也在服务器端进行验证（不仅仅是通过CORS响应标头）。

托盘模式（Linux）

使用系统托盘图标将盘片作为持久后台服务运行：

platter --tray

这意味着 --transport=http 并补充道：

系统托盘图标 通过DBus（StatusNotifierItem协议），与KDE、GNOME（带AppIndicator扩展）和其他桌面环境兼容。
持久配置 在 ~/.config/platter/config.json --身份验证令牌、启用的工具、端口、主机和工作目录在重启后仍然有效。
动态工具切换 --在运行时从托盘菜单启用或禁用单个工具。更改会持续存在并立即生效。
身份验证令牌管理 --将服务器URL或身份验证令牌复制到剪贴板，或重新生成令牌。令牌在可用时存储在系统密钥环中，回退到配置文件。
服务器控件 --从托盘菜单启动、停止和重新启动HTTP服务器。

Linux安装程序

这 linux/install.sh 脚本执行用户级安装（否 sudo 必填）：

./linux/install.sh                  # install
./linux/install.sh --uninstall      # remove

这将安装：

~/.local/bin/platter --二进制
~/.local/share/applications/platter.desktop --桌面启动器条目
~/.local/share/icons/hicolor/scalable/apps/platter.svg --应用程序图标
~/.config/systemd/user/platter.service --用于自动启动的systemd用户单元

安全

网络（HTTP模式）

TLS（HTTPS） -可选传输加密，通过 --tls-cert 和 --tls-key.使用Node.js https 带有PEM编码证书和密钥文件的模块。
OAuth 2.1+PKCE (--auth oauth，默认）-MCP客户端通过授权码流使用PKCE进行身份验证(RFC 7636).支持动态客户端注册(RFC 7591)令牌撤销(RFC 7009).
外部JWKS/OIDC (--auth jwks)-资源服务器模式：盘片根据发行者的JWKS验证来自外部发行者（Auth0、Keycloak、Okta、Entra）的JWT访问令牌，验证签名， iss, aud，以及 exp仅适用于非对称算法(alg: none 并且HMAC被拒绝）。请参阅 外部JWKS/OIDC 下节认证用于配置。
带外同意确认 -OAuth同意页面需要一个仅向盘片操作员显示的确认码（通过stderr或桌面通知）。这可以防止CSRF和跨源攻击自动批准授权请求。同意页面也受到保护 X-Frame-Options: DENY, Sec-Fetch-Site 验证，以及 Origin 标题检查。
承载令牌身份验证 -静态承载令牌（RFC 6750）可作为回退 oauth 模式和作为唯一的方法 bearer 模式。启动时会生成一个随机的256位令牌，除非您提供 --auth-token 或设置 --auth none.
主机标头验证 -防止 DNS重新绑定攻击本地主机绑定仅接受 127.0.0.1, localhost，以及 ::1；远程绑定只接受指定的 --host.
原产地验证 -何时 --cors-origin 设置为特定来源，请求不匹配 Origin 标头被403主动拒绝（不仅仅是通过CORS响应标头过滤）。

限制（尽最大努力）

--tools, --allow-path，以及 --allow-command 是 纵深防御 控制。它们大大提高了标准，但不是沙箱。在威胁模型中依赖以下限制之前，应该先了解它们。

他们擅长什么

工具选择 在注册时执行。禁用的工具永远不会通过MCP协议暴露。客户端无法调用或发现它们。
路径验证 通过以下方式解析符号链接 realpath() 在比较之前，在目标和每个允许的路径上，防止通过以下路径遍历 ../ 或符号链接目录。对于尚不存在的写入目标，将解析最近的现有祖先。
命令验证 锚定正则表达式模式以匹配完整的命令字符串，防止附加等琐碎的绕过 && malicious-command.

已知的限制和旁路

Bash本质上是不受限制的。 启用bash工具后，一个足够有创意的命令可以绕过 --allow-path 完全（例如。 cat /etc/passwd).如果你设置 --allow-path 无需设置 --allow-command 或从中删除bash --tools，启动时会打印警告。对于强文件访问控制，请禁用bash(--tools read,write,edit,glob,grep)或成对 --allow-path 与一个紧 --allow-command 对抗主义者。
这 js 该工具不是安全沙箱。 它在Node.js中运行代码 vm 上下文，其中 Node自己的文档明确指出不一种安全机制——不可信代码可以通过已知技术逃离上下文。即使没有转义，运行时也会暴露 fetch （任意网络访问，包括私有/环回地址）， Buffer和a load() 从下载并执行任意代码的助手 unpkg.com 或任何其他URL --allow-path, --allow-command, --sandbox，或 --sandbox-allow-url 适用于 js 工具——这些标志只影响文件和bash工具。如果 js 工具启用后，将服务器视为具有与不受限制的bash大致相同的爆炸半径。要禁用它： --tools read,write,edit,bash,glob,grep。为了实现强隔离，请在容器或VM内运行盘片。
命令正则表达式对原始字符串进行操作。 它不解析shell语法。图案如 --allow-command "git( .*)?" 块 rm && git status （因为完整字符串不匹配），但一个有决心的攻击者可以构造正则表达式匹配但执行意外代码的命令，例如，如果允许的模式太宽。尽可能窄地写模式。
Symlink 触摸。 路径验证在检查时解析符号链接。如果在检查和实际文件操作之间更改了符号链接目标，则可以绕过验证。这是用户空间路径检查的一个基本限制。
Glob/grep搜索范围。 --allow-path 验证glob和grep的搜索目录，但该目录树中的结果可能包含指向其外部的符号链接。这些符号链接目标的内容可以在grep输出中返回或由glob列出。
没有进程级沙盒。 所有限制都在盘片进程中的应用程序代码中强制执行。它们不使用操作系统级机制（seccomp、命名空间、质押等）。盘片本身、Bun或依赖关系中的漏洞可以绕过所有限制。

为了加强隔离，请使用bash沙盒、Docker容器或两者兼而有之。

沙盒模式（仅bash）

选择加入只是bash，一个带有虚拟文件系统的bash的TypeScript重新实现，用于沙盒命令执行。不生成本地进程；shell完全在Bun运行时中运行。

platter --sandbox                                               # readwrite fs, no network
platter --sandbox --sandbox-fs memory                           # pure in-memory fs
platter --sandbox --sandbox-fs overlay                          # reads from disk, writes ephemeral
platter --sandbox --sandbox-allow-url "https://api.example.com" # allow network to prefix

文件系统模式

模式	读取	写入	用例
`memory`	仅虚拟	仅虚拟	最大隔离，根本没有磁盘访问
`readwrite` （默认）	真实磁盘	真实磁盘	Sandbox执行，具有真实文件访问权限
`overlay`	真实磁盘	内存中（临时）	探索文件而无修改风险

网络接入

网络访问是 默认情况下禁用.使用 --sandbox-allow-url （可重复）以允许访问特定的URL前缀。私有/环回IP始终被拒绝。

platter --sandbox --sandbox-allow-url "https://api.github.com" --sandbox-allow-url "https://registry.npmjs.org"

与其他限制的交互

--allow-path：In readwrite 和 overlay 在模式中，每个允许的路径都被挂载到沙箱中。在 memory 模式， --allow-path 被忽略。
--allow-command：在沙盒执行命令之前，命令正则表达式验证仍然适用。
--sandbox 抑制bash+ --allow-path 警告，因为沙盒强制执行文件系统边界。

局限性

不是完整的bash。 只是bash是TypeScript的重新实现；一些边缘案例的行为可能与GNU bash不同。
没有本机二进制文件。 命令如下 git, node, docker, rg, python 不可用。只有bash内置程序和bash的内置命令集可以工作。
Beta软件。 justbash正在积极开发中。在生产中依赖工作流之前，先测试一下它。

容器隔离（Docker）

在Docker容器中运行盘片通过Linux命名空间和cgroups提供操作系统级隔离。容器边界限制了bash工具可以访问的内容。即使是不受限制的命令也只能访问容器公开的文件系统和网络。

# Minimal: no host filesystem, no network
docker run --rm -i --network none ghcr.io/hadriangateway/platter

# Read-only project access, no bash
docker run --rm -p 3100:3100 \
  -v /home/user/project:/work:ro \
  ghcr.io/hadriangateway/platter -t http --host 0.0.0.0 --tools read,glob,grep

# Full tools, scoped to a mounted directory
docker run --rm -p 3100:3100 \
  -v /home/user/project:/work \
  ghcr.io/hadriangateway/platter -t http --host 0.0.0.0 --allow-path /work

容器执行什么

文件系统边界。 仅显式挂载路径(-v)可见。即使启用了bash，命令也无法读取或写入未挂载的主机路径。
网络边界。 --network none 完全禁用网络。没有它，容器可以出站访问，但无法访问仅主机服务，除非 --network host 使用。
过程隔离。 容器内的进程无法看到或通知主机进程。
资源限制。 Docker的 --memory, --cpus，以及 --pids-limit 标志可以限制资源使用，以防止拒绝服务。

容器与虚拟机

容器共享主机内核；隔离是由内核特性（名称空间、cgroups、seccomp）强制执行的。内核漏洞或配置错误的容器（例如。 --privileged)可以打破界限。虚拟机在虚拟化硬件上运行单独的内核，因此客户机妥协不会直接暴露主机。如果您的威胁模型包含可能试图利用内核漏洞的不受信任的代码，请在VM（或VM支持的容器运行时，如卡塔集装箱或爆竹).对于大多数用例，比如限制AI代理的爆炸半径，一个配置正确的容器（非根，功能下降， --network none)足够了。

结合沙箱和容器

bash沙箱和Docker容器分别处理不同的层。它们一起使用，可以提供深度防御：

层	防止
只是bash沙盒	任意本机进程执行：否 `git`, `curl`, `rm`等等。命令在TypeScript解释器中运行，而不是在OS shell中运行。
Docker 容器	主机文件系统/网络访问：即使沙盒有错误或被绕过，容器也会将爆炸半径限制在挂载路径和允许的网络上。

# Maximum isolation: sandbox inside a container, overlay fs, no network
docker run --rm -i --network none \
  -v /home/user/project:/work:ro \
  ghcr.io/hadriangateway/platter --sandbox --sandbox-fs overlay

# Sandbox with controlled network access inside a container
docker run --rm -p 3100:3100 \
  -v /home/user/project:/work \
  ghcr.io/hadriangateway/platter -t http --host 0.0.0.0 \
    --sandbox --sandbox-allow-url "https://api.github.com"

为了获得最高的安全性，还可以以非root用户身份运行容器(--user)，放弃所有功能(--cap-drop ALL)，并将文件系统设置为只读(--read-only)使用tmpdir进行任何所需的写入：

docker run --rm -p 3100:3100 \
  --user 1000:1000 \
  --cap-drop ALL \
  --read-only --tmpfs /tmp \
  -v /home/user/project:/work \
  ghcr.io/hadriangateway/platter -t http --host 0.0.0.0 --sandbox

看码头工人获取完整的使用说明，包括安装路径、网络和构建自定义映像。

码头工人

Docker镜像基于Debian Bookworm（slim），并包含ripgrep。多拱形图像(linux/amd64, linux/arm64)在每个标记的版本上发布到GitHub容器注册表。

docker pull ghcr.io/hadriangateway/platter        # latest release
docker pull ghcr.io/hadriangateway/platter:1.0.0  # specific version

在stdio模式下运行

通过stdin/stdout传输JSON-RPC消息：

docker run --rm -i ghcr.io/hadriangateway/platter

在HTTP模式下运行

绑定到 0.0.0.0 在容器内部，因此可以从主机访问端口：

docker run --rm -p 3100:3100 ghcr.io/hadriangateway/platter -t http --host 0.0.0.0

安装路径

将主机目录装载到容器中并使用 --cwd 或 --allow-path 要提供盘片访问权限：

# Mount a project directory as the working directory
docker run --rm -p 3100:3100 \
  -v /home/user/project:/work \
  ghcr.io/hadriangateway/platter -t http --host 0.0.0.0

# Mount read-only
docker run --rm -p 3100:3100 \
  -v /home/user/project:/work:ro \
  ghcr.io/hadriangateway/platter -t http --host 0.0.0.0 --tools read,glob,grep

# Mount multiple directories with path restrictions
docker run --rm -p 3100:3100 \
  -v /home/user/project:/project \
  -v /tmp/scratch:/scratch \
  ghcr.io/hadriangateway/platter -t http --host 0.0.0.0 \
    --cwd /project \
    --allow-path /project --allow-path /scratch

网络

默认情况下，容器具有完全的出站网络访问权限。你可以通过Docker的网络选项来限制这一点：

# No network access (file-only tools)
docker run --rm --network none -i ghcr.io/hadriangateway/platter

# Access host services (e.g. a local database)
docker run --rm -p 3100:3100 --network host ghcr.io/hadriangateway/platter -t http --host 0.0.0.0

在运行时安装其他软件

该镜像使用Debian，因此您可以安装带有 apt-get 在运行时。这对于快速实验很有用，但会增加启动延迟。对于生产使用，请构建一个自定义映像（见下文）。

docker run --rm -p 3100:3100 ghcr.io/hadriangateway/platter \
  bash -c "apt-get update && apt-get install -y git nodejs && exec platter -t http --host 0.0.0.0"

或交互式：

docker run --rm -it --entrypoint bash ghcr.io/hadriangateway/platter
# inside the container:
apt-get update && apt-get install -y git python3
platter -t http --host 0.0.0.0

构建自定义映像

在盘片映像之上添加额外的工具，以实现即用型环境：

FROM ghcr.io/hadriangateway/platter:latest

RUN apt-get update \
 && apt-get install -y --no-install-recommends \
      git \
      curl \
      python3 \
      nodejs \
      npm \
 && rm -rf /var/lib/apt/lists/*

构建并运行：

docker build -t my-platter .
docker run --rm -p 3100:3100 -v ~/project:/work my-platter -t http --host 0.0.0.0

在当地建立形象

docker build -t platter .
docker run --rm -i platter

构建

bun install
bun run build        # bundle to dist/
bun run compile      # standalone binary for current platform -> ./platter
bun run compile:all  # cross-compile for linux-x64, linux-arm64, darwin-x64, darwin-arm64
bun run format       # format with Biome
bun run format:check # check formatting
bun run lint         # lint with Biome
bun run lint:fix     # lint and auto-fix with Biome
bun run typecheck    # typecheck with TypeScript
bun run test         # run tests

许可证

麻省理工学院

使用说明

大浅盘

工具

快速启动

从发布二进制文件

码头工人

来源

用法

限制

工具选择

路径限制

命令限制

组合示例

认证

OAuth 2.1(--auth oauth)

持有者代币(--auth bearer)

无身份验证(--auth none)

外部JWKS/OIDC(--auth jwks)

TLS（HTTPS）

标准模式

HTTP模式（流式HTTP）

托盘模式（Linux）

Linux安装程序

安全

网络（HTTP模式）

限制（尽最大努力）

他们擅长什么

已知的限制和旁路

沙盒模式（仅bash）

文件系统模式

网络接入

与其他限制的交互

局限性

容器隔离（Docker）

容器执行什么

容器与虚拟机

结合沙箱和容器

码头工人

在stdio模式下运行

在HTTP模式下运行

安装路径

网络

在运行时安装其他软件

构建自定义映像

在当地建立形象

构建

许可证

相关 MCP

文件与终端管理MCP服务

iOS/macOS 构建 MCP 服务器与命令行工具

小红书内容访问服务

Shell与编码MCP服务器

生物医学数据检索命令行与MCP服务

容器沙箱 MCP 服务器

OAuth 2.1(`--auth oauth`)

持有者代币(`--auth bearer`)

无身份验证(`--auth none`)

外部JWKS/OIDC(`--auth jwks`)