v0.3.0 · 123 tools · 13 modules

Docker management
for AI agents

Arcane MCP is a Model Context Protocol server that gives AI agents full control over Docker โ€” containers, images, volumes, networks, Compose projects, and more.

123
MCP tools
13
tool modules
3
dependencies

How it works

AI agents talk to Docker through a lightweight MCP server. The Arcane API handles the infrastructure โ€” Arcane MCP handles the protocol.

๐Ÿค–
AI Agent
OpenCode, Claude, Cursor
โ†’
โšก
Arcane MCP
123 tools ยท FastMCP
โ†’
๐Ÿ”Œ
Arcane API
Docker abstraction layer
โ†’
๐Ÿณ
Docker
Containers, images, volumes
Every tool returns structured JSON. Destructive ops require explicit confirmation.

Everything Docker, every tool

13 module categories covering the full Docker API surface โ€” from containers to vulnerability scanning.

๐Ÿ“ฆ

Containers

18 tools

Create, start, stop, kill, pause, exec, logs, stats, auto-update — full container lifecycle.

๐Ÿ–ผ๏ธ

Images

19 tools

Pull, push, build, tag, prune, scan vulnerabilities, export, view history and attestations.

๐Ÿ’พ

Volumes

18 tools

Create, inspect, backup, restore, browse files, read/write inside volumes, prune unused.

๐ŸŒ

Networks

9 tools

Create, connect, disconnect, inspect topology, prune unused networks across environments.

๐Ÿ“‹

Compose Projects

17 tools

Deploy, update, scale, restart, archive, inspect runtime state — full Compose lifecycle.

๐Ÿ›ก๏ธ

Vulnerabilities

6 tools

Scan images, list CVEs, ignore/unignore findings, check scanner health across the fleet.

โš™๏ธ

System

9 tools

Docker info, version, prune, health check, upgrade management, bulk container ops.

๐Ÿ”

Registries

6 tools

Manage container registries — create, update, test connectivity, delete.

๐Ÿ“ก

Webhooks

5 tools

Trigger, list, create, update, delete inbound webhooks for event-driven automation.

๐Ÿ“Š

Activities & Events

7 tools

List and cancel background activities, browse system events, delete stale entries.

๐ŸŒ

Environments

5 tools

Manage multiple Arcane environments — local Docker, remote agents, multi-tenant setups.

๐Ÿ”„

Updater

3 tools

Run, monitor, and review the container updater — keep images fresh across the stack.

๐Ÿ”Œ

Ports

1 tool

List all port mappings across every container and environment in one call.

Start in 30 seconds

Install, configure, connect. Three steps and your agent talks to Docker.

1

Install

Not on PyPI. Install directly from GitHub.

# pip from GitHub
pip install git+https://github.com/MikeCase/arcane-mcp.git

# or with uv
uv tool install git+https://github.com/MikeCase/arcane-mcp.git

# or clone and install locally
git clone https://github.com/MikeCase/arcane-mcp.git
cd arcane-mcp && uv sync
2

Configure

Set your Arcane instance URL and API key. Drop them in a .env or set as env vars.

# .env
ARCANE_API_KEY=arc_your_key_here
ARCANE_BASE_URL=http://localhost:3552
3

Connect

Add to your opencode.jsonc and restart — all 123 tools appear automatically.

// opencode.jsonc
{
  "mcp": {
    "arcane-docker": {
      "type": "local",
      "command": ["arcane-mcp"]
    }
  }
}

Built for safety

Docker operations are powerful. Every destructive action requires explicit confirmation.

๐Ÿ›ก๏ธ

Confirm before destroy

Every tool that removes, prunes, kills, restores, or overwrites requires
confirm=True — without it, the tool returns a warning.

# Without confirm โ€” safe warning
remove_container("my-app")
# โ†’ {"warning": "Destructive operation. Set confirm=True...",
# "container_id": "my-app"}