MCP server for Apple containers - run AI agents in VM-isolated sandboxes on your Mac
Container-mcp has well-structured tool definitions with complete JSON schemas and descriptions for all 13 tools. Naming follows verb_noun convention (list_containers, run_container, etc.). Descriptions are clear and action-oriented (avg ~120 chars), explaining WHAT the tool does and WHEN to use it. Parameters include type constraints (minLength, minimum, maximum, enums for protocol field). However, several tools lack output schema documentation, and some descriptions could better explain error recovery paths. Tool annotations (destructiveHint, readOnlyHint) are present and correctly applied. No deprecated patterns detected. STDIO transport limits remote accessibility.
Build an image from a Dockerfile. The build context must be inside an allowed host path.
Fetch the most recent log lines from a container (default: last 100). The tail is applied server-side via the CLI -n flag.
Get CPU and memory usage statistics for a container.
Get detailed information about a container as JSON.
List containers as JSON. Pass all: true to include stopped containers.
List local container images as JSON.
Remove dangling images to reclaim disk. Pass all: true to remove all unused images.
Output schemas not documented. Tools like inspect_container, container_stats, list_images return JSON but LLMs cannot predict field structure for downstream chaining.
Error recovery guidance missing. Descriptions do not explain what to do if a container fails to start, a pull times out, or a build fails. LLMs have no recovery path.
run_container description mentions '10 minute limit' but does not explain timeout behavior or how to increase it via CONTAINER_MCP_TIMEOUT_MS. LLMs cannot self-correct on timeout.
list_images and list_containers lack pagination parameters (limit, offset). Large image/container lists could exceed context window without truncation guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2025-06-18+ | v2 |
Pull an OCI image from a registry, e.g. 'alpine:latest'.
Delete a container. Pass force: true to delete a running container.
Delete a local image by reference. Pass force: true to remove even if in use.
Run a container inside its own lightweight VM. By default runs detached and returns the container ID. Pass wait: true to run to completion and return the container's output (10 minute limit). Mount sources must be inside the allowed host paths. Default CPU/memory limits are applied unless overridden.
Stop a running container.
Check whether the Apple container system service is running. Pass start: true to start it if it is stopped.
system_status description is vague ('Check whether the Apple container system service is running'). Does not explain when to call it or what 'running' means operationally.