Tidesman

Tidesman

一款免费的原生 MCP 服务，使用 Apple 的 container 工具运行、了解和调试 Linux 容器。

网站 · 下载

它让 AI 助手（Claude Desktop、Claude Code 或任何兼容 MCP 的客户端）能够在 Mac 上列出、运行、检查和清理 Linux 容器，安全无虞，并留下完整的审计记录。

此仓库是 Tidesman 的公开下载与文档主页。源代码由我们私下维护；此处发布的二进制文件均使用 Apple Developer ID 证书签名，并经 Apple 公证。

演示

首个版本发布时将提供演示。

简介

MCP（Model Context Protocol，模型上下文协议）是一项开放标准，让 AI 助手能够调用外部工具：这些小型函数可以执行实际操作，例如列出或启动容器。Tidesman 是该标准的服务端：它提供一组容器工具，由 AI 客户端调用。

Apple 的 container 是 Apple 在 macOS 上运行 Linux 容器的工具。通常，你需要在终端中输入命令来操控它。而 Tidesman 会使用 Apple 自己的 Swift 客户端库，直接与 container 所依赖的后台服务（即其“apiserver”）通信。直接连接该服务，比封装命令行更快、更可靠。

要求

• 运行 macOS 26 的 Apple Silicon Mac（Apple 的容器运行时需要同时满足这两项要求）。
• 已安装并启动 Apple 的 container：container system start。

安装

Tidesman 是已签名并经公证的二进制文件。请选择适合你的安装渠道。

Homebrew（推荐）

brew install JeronimoColon/tidesman/tidesman

这会添加 tap，并将 tidesman 安装到 /opt/homebrew/bin。

安装程序包（.pkg）

从最新版本下载 tidesman-<version>.pkg，双击打开，然后按提示操作。它会将 tidesman 安装到 /usr/local/bin。该程序包已签名、公证并装订票据，因此即使离线也能通过验证。

直接下载二进制文件（zip）

下载 tidesman-<version>-macos-arm64.zip，解压后将 tidesman 移动到 PATH 中。由于独立二进制文件未装订票据，macOS 首次运行时会在线检查它。

Claude Desktop 一键安装（.mcpb）

下载 tidesman-<version>.mcpb 并使用 Claude Desktop 打开（Settings → Extensions）。该捆绑包内含已签名的二进制文件，并会自动以只读模式为你注册此服务。

验证下载文件

每个版本都会附带一个 SHA256SUMS 文件。在存放下载文件的文件夹中运行：

shasum -c SHA256SUMS

配置 MCP 客户端

Tidesman 作为本地命令运行，由客户端通过标准输入/输出启动。将客户端指向该二进制文件，并通过 --mode 指定访问模式（省略时为只读）。

Claude Desktop，编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "tidesman": {
      "command": "/opt/homebrew/bin/tidesman",
      "args": ["--mode=safe"]
    }
  }
}

Claude Code：

claude mcp add --transport stdio --scope user tidesman \
  -- /opt/homebrew/bin/tidesman --mode=safe

任何 stdio MCP 客户端（OpenAI Codex 等）都可以采用相同方式运行：将客户端指向该二进制文件，并将标志作为参数传入。

功能

共有 20 个工具，每个工具都按其能力标记为 Read、Write 或 Destructive。三个工具用于报告或修复引擎本身，十一个用于操作容器，六个用于操作镜像：

工具	能力	功能说明
system_ping	Read	检查容器服务是否可访问
system_disk_usage	Read	报告镜像、容器和卷的磁盘使用情况
system_repair	Write	重新下载引擎自身的基础设施镜像
container_list	Read	列出容器
container_inspect	Read	显示容器的完整详情
container_logs	Read	获取容器的最新输出
container_run	Write	根据镜像创建并启动容器
container_exec	Write	在运行中的容器内执行命令
container_start	Write	启动已有的已停止容器
container_restart	Write	优雅地停止容器，然后重新启动
container_stop	Write	优雅地停止正在运行的容器
container_kill	Write	向容器发送信号以停止它（默认发送 SIGKILL）
container_delete	Destructive	删除容器
container_prune	Destructive	一次性删除所有已停止的容器
image_list	Read	列出已下载的镜像
image_inspect	Read	显示镜像的完整详情
image_pull	Write	从注册表下载镜像
image_tag	Write	为现有镜像指定另一个名称
image_delete	Destructive	删除镜像
image_prune	Destructive	一次性删除未标记的镜像（或所有未使用的镜像）

能力标记的含义：Read 工具只观察状态，不会进行任何更改。Write 工具会更改状态，但不会删除资源；已停止的容器在启动或重启后仍然存在，而引擎修复只会恢复引擎所需的内容。Destructive 专用于删除容器或镜像。MCP 客户端可能会根据每个工具携带的 MCP 提示，将某些 Write 工具（exec、stop、kill、restart）单独标记为具有破坏性：这些工具可能会终止工作或更改容器内的数据，即使容器本身仍然存在。在任何模式下，助手都能看到全部 20 个工具；如果某个工具被当前模式锁定，其说明会明确指出，并且在提升模式之前会拒绝执行。

访问模式：默认安全

Tidesman 以三种权限级别之一运行，通过 --mode= 设置，启动时使用最安全的级别。如果未指定 --mode，则为只读。助手始终能看到所有工具；模式决定哪些工具可以运行。

模式	允许的能力	可调用的工具
read-only（默认）	Read	ping、磁盘使用情况、list、inspect、logs，以及两个镜像读取工具（7 个）
safe	Read + Write	上述工具，以及 run、exec、start、restart、stop、kill、image pull 和 tag，以及引擎修复（16 个）
full	Read + Write + Destructive	全部 20 个工具，包括 delete 和 prune 工具

单独的标志 --allow-host-mounts=/path/one[,/path/two] 用于指定 container_run 可以挂载到容器中的主机文件夹；默认关闭，因为主机挂载会越过容器的隔离边界，访问你实际的文件。只有当挂载路径的实际路径（解析符号链接后）位于你列出的某个文件夹之下时，才允许挂载。

安全与信任

• 已签名并经过公证。二进制文件使用 Apple Developer ID 证书签名，并经 Apple 公证，因此 Gatekeeper 运行时不会发出警告。
• 默认安全。未设置模式时为只读；破坏性操作需要 full；挂载主机目录需要显式标志。
• 可审计。每次工具调用都会记录到 ~/Library/Logs/tidesman/audit.log 和 macOS 统一日志中：包括工具名称、参数（会对类似机密的值进行隐藏）及执行结果。破坏性调用还会准确记录其删除的内容；工具未声明的参数也会按名称记录，因此误操作会留下清晰痕迹。
• 工具注解真实可靠。每个工具声明的 MCP 只读和破坏性提示都与其实际可操作范围相符，因此客户端了解风险，并可在任何高风险操作运行前询问。
• 保护好客户端配置。Tidesman 的工具无法更改访问模式；该模式由 MCP 客户端配置文件中的 --mode 参数固定。该文件不受 Tidesman 控制，因此请妥善保护：如果客户端授予其助手广泛的文件系统访问权限，助手就能修改自己的模式。每条审计日志都会记录调用运行时所用的模式，因此任何更改都会留下清晰痕迹。

隐私政策

Tidesman 不收集任何关于你的信息，也不会向我们发送任何内容：没有遥测、分析、崩溃报告或账户。一切操作都在你的 Mac 上进行。

• 审计日志（工具调用、已隐藏类似机密值的参数及执行结果）仅写入你的 Mac（~/Library/Logs/tidesman/audit.log 和 macOS 统一日志），除非你主动分享，否则会一直留在本机。你可以随时删除。
• Tidesman 不开放网络端口。唯一的出站连接是在你或你的助手要求其拉取镜像时，连接到容器注册表（例如 Docker Hub）；该请求会像任何容器工具一样，将镜像名称和你的网络地址发送给注册表。
• 不会与任何其他人分享、出售信息，也不会将信息保留给任何其他人。

完整政策见 tidesman.dev/privacy.html。 隐私问题请联系：[email protected]。

许可证

Tidesman 是专有软件，根据最终用户许可协议 EULA.txt 免费提供。它包含开源组件，其相关声明保存在 THIRD-PARTY-LICENSES 中。

链接

• 网站：https://tidesman.dev
• 报告问题：https://github.com/JeronimoColon/tidesman-mcp/issues
• 联系方式：[email protected]