Tidesman — Claude Code MCP server: what it does, how to install
Runs and inspects Linux containers on macOS via Apple's container tool. Helpful when testing code in isolated environments directly from the assistant.
Open on GitHubWhat Tidesman does
Tidesman connects MCP clients to Apple's container tool on macOS. The server bypasses command line wrappers. It talks directly to the background apiserver over XPC via Swift. This exposes twenty tools for image management and process execution.
System prerequisites are strict. You need an Apple Silicon Mac and macOS 26. The server fails immediately if Apple's container service is not running beforehand. One can also pass the --mode flag to disable destructive actions like deleting images or stopping active containers.
What it helps with
- spin up a Linux container from an image to test code
- execute commands and fetch logs inside an active container
- inspect disk space consumed by images and volumes
- prune unused images and stopped containers
Example prompts for the agent
- Call
container_listto see what is currently running. - Run the test suite inside the container using
container_exec. - Check recent output for this container with
container_logs.
How to install Tidesman
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Tidesman
How to install Tidesman in Claude Code?
Download the binary for Mac via Homebrew or a release package, then ensure Apple container service is running. After that, register the executable path in your MCP client settings with the chosen access mode.
What does Tidesman do?
It gives AI clients twenty tools to run and inspect Linux containers on macOS. Assistants can read logs, execute commands, check images, and clean up idle resources.
What are the system requirements for Tidesman?
You need an Apple Silicon Mac running macOS 26. In addition, Apple's background container service must be installed and active on the machine.