Smyth Docker CommanderSAFE
An MCP server that can spawn linux sandbox containers using docker and run commands in them via a TTY interface.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A Model Context Protocol (MCP) server built with @smythos/sdk that can spawn an ephemeral Linux sandbox using Docker and execute commands inside it via an interactive TTY.
Claude code demo
https://github.com/user-attachments/assets/b7b9b8c9-29da-43d1-8414-a45762245067
Gemini-cli demo
https://github.com/user-attachments/assets/db109ab2-65e2-40e8-be2b-fd0f01e4a217
Key Features:
- Full TTY Interface: Exposes a complete terminal interface allowing MCP clients to send commands, keystrokes, and special key sequences while capturing all output in real-time
- Collaborative Interaction: While the MCP server is running, both the AI client (Claude/Gemini) and the human user can simultaneously interact with the same container terminal, enabling true "teamwork" scenarios
- Real-time Output Capture: Maintains a rolling buffer of terminal output that clients can read at any time to understand the current state
When launched, it starts an MCP server over Server-Sent Events (SSE) and exposes a set of skills that MCP clients (e.g., Claude Code, gemini-cli) can call:
- SpawnContainer: Pulls the specified image (default
ubuntu:latest) and starts a TTYbashsession. - SendTTYInput: Sends input to the container TTY. Interprets only
\r(carriage return). Use this to send shell commands terminated with\r. - SendTTYInputWithEscapeSequences: Sends input and interprets common escape sequences (e.g.,
\r,\b,\t,\x1b, octal like\033). - GetScreenContent: Returns the rolling output buffer (last ~5–10k chars) from the container.
- StopAndDestroyContainer: Stops and removes the container, restoring the local terminal.
It uses dockerode under the hood and provides a status line UI in the terminal.
Getting Started
Prerequisites
- Node.js v20+
- Docker Desktop/Engine running and accessible (the server pings Docker and will error if unavailable)
- An Open
06fe3ce74315OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add smyth-docker-mcp -- npx -y [email protected]
{
"mcpServers": {
"smyth-docker-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Exposed tools (3)
2 read · 0 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
GetScreenContent | read | Reads the current screen buffer. use it to read the output of a recent command or know what is being displayed on the screen. |
SpawnContainer | read | Spawns a new linux container. |
StopAndDestroyContainer | destructive | Stop and destroy a linux container. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (5)
StopAndDestroyContainer
MCP url: http://127.0.0.1:PORT/mcp
"url": "http://127.0.0.1:PORT/mcp"
"url": "http://127.0.0.1:PORT/mcp"
@smythos/sdk, dockerode, @rollup/plugin-json, @types/node, rollup-plugin-esbuild, rollup-plugin-sourcemaps, rollup-plugin-typescript-paths
Gates applied: no_behavioural_pass.
06fe3ce74315full audit observations/trust-audit/mcp-server/smythos__smyth-docker-commander.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 06fe3ce74315 | SAFE | B | 89 | first audit |
Questions
What is the Smyth Docker Commander MCP server?
An MCP server that can spawn linux sandbox containers using docker and run commands in them via a TTY interface.
What tools does Smyth Docker Commander expose?
3 in total: 2 read-only, 0 that write, and 1 that can delete or overwrite (StopAndDestroyContainer). Every one is listed on this page with its risk.
Is Smyth Docker Commander safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Smyth Docker Commander need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (06fe3ce74315), read on 2026-10-08. The repository is watched and re-audited when it changes.