Skip to main content
Glama
arcane-mcp
by MikeCase

arcane-mcp

An MCP server that exposes Arcane Docker management capabilities to AI agents via the Model Context Protocol. Built with FastMCP.

Covers the core Docker management API: containers, images, volumes, networks, Compose projects, registries, vulnerability scanning, port mappings, webhooks, system management, updater, activities/events, and environment management.

125 tools across 14 modules.

Install

Not on PyPI. Install directly from GitHub:

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

# 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

Related MCP server: MCP Dockhand

Configuration

Set these environment variables (or put them in a .env file in the working directory):

ARCANE_API_KEY=arc_your_api_key_here
ARCANE_BASE_URL=http://localhost:3552

OpenCode

Add to your opencode.json:

{
  "mcp": {
    "arcane-docker": {
      "type": "local",
      "command": ["arcane-mcp"],
      "env": {
        "ARCANE_API_KEY": "arc_your_key_here",
        "ARCANE_BASE_URL": "http://localhost:3552"
      }
    }
  }
}

Or set environment variables globally and omit them from the config.

Tools (125 total)

Containers (18)

list_containers, inspect_container, create_container, start_container, stop_container, restart_container, kill_container, pause_container, unpause_container, remove_container, redeploy_container, commit_container, update_container, set_container_auto_update, exec_in_container, get_container_logs, get_container_stats, get_container_counts

Images (19)

list_images, inspect_image, pull_image, remove_image, tag_image, prune_images, get_image_counts, build_image, search_images, upload_image, get_image_history, get_image_export, get_image_attestations, scan_image_vulnerabilities, get_image_vulnerabilities, get_vulnerability_summary, check_image_update, check_all_image_updates, get_image_update_summary

Volumes (18)

list_volumes, create_volume, inspect_volume, remove_volume, prune_volumes, get_volume_counts, get_volume_sizes, get_volume_usage, list_volume_backups, create_volume_backup, restore_volume_backup, delete_volume_backup, download_volume_backup, browse_volume, read_volume_file, create_volume_directory, upload_to_volume, delete_volume_file

Projects / Compose (17)

list_projects, get_project, deploy_project, redeploy_project, remove_project, update_project, get_project_counts, project_down, restart_project, build_project, archive_project, unarchive_project, pull_project_images, get_project_compose, get_project_file, update_project_services, get_project_runtime

Networks (9)

list_networks, create_network, inspect_network, remove_network, connect_container_to_network, disconnect_container_from_network, prune_networks, get_network_counts, get_network_topology

Environments (5)

list_environments, get_environment, create_environment, update_environment, remove_environment

System (9)

get_docker_info, get_docker_version, prune_system, get_system_health, check_system_upgrade, trigger_upgrade, start_all_containers, start_stopped_containers, stop_all_containers

Activities & Events (7)

list_activities, get_activity, cancel_activity, clear_activity_history, list_events, get_environment_events, delete_event

Container Registries (6)

list_registries, create_registry, get_registry, update_registry, delete_registry, test_registry

Vulnerabilities (6)

get_vulnerability_summary_all, list_all_vulnerabilities, ignore_vulnerability, list_ignored_vulnerabilities, unignore_vulnerability, get_scanner_status

Webhooks (5)

trigger_webhook, list_webhooks, create_webhook, update_webhook, delete_webhook

Updater (3)

run_updater, get_updater_status, get_updater_history

Ports (1)

list_ports

Operations / Safety (2)

confirm_operation, read_audit_log

Usage

All resource tools accept env_id: str = "0" to target a specific Arcane environment (local Docker is "0", remote agents use UUIDs). Remote agent operations can pass agent_token: str | None for authentication via the X-Arcane-Agent-Token header.

Safety

Destructive operations use a three-layer safety system:

1. Confirmation tokens (two-step handshake)

Every tool that removes, prunes, kills, restores, or overwrites returns a short-lived confirmation_token instead of executing. The agent must call confirm_operation(token) as a separate tool call to proceed. Tokens expire after 120 seconds.

remove_container("my-app")
→ {"warning": "...", "confirmation_token": "a1b2c3d4e5f6", "target": "my-app"}

confirm_operation(token="a1b2c3d4e5f6")
→ {"success": true, ...}

This prevents an agent from blasting through a safety gate in one call — it must stop, process the warning, and make a second call.

2. Dry-run mode (prune/cleanup tools)

Prune operations (prune_images, prune_volumes, prune_networks, prune_system, clear_activity_history) default to dry_run=True, showing what would be affected without making changes:

prune_images()
→ {"dry_run": true, "warning": "Dry-run. Set dry_run=False to proceed.", "target": "all"}

prune_images(dry_run=False)
→ {"warning": "...", "confirmation_token": "..."}

3. Audit log

Every confirmed destructive operation is recorded to a structured JSON-lines audit log. Read it anytime:

read_audit_log(lines=10)
→ [{"timestamp": "2026-06-29T...", "action": "remove_container", "target": "my-app", "env_id": "0"}]

Set ARCANE_MCP_AUDIT_LOG environment variable to change the log file path (default: ~/.arcane-mcp-audit.log).

Development

git clone https://github.com/MikeCase/arcane-mcp.git
cd arcane-mcp
uv sync
uv run fastmcp run src/arcane_mcp/server.py

License

MIT

Available Tools

127 tools
archive_projectC

Archive a Compose project.

Inputs: project_id (required), env_id, agent_token.

browse_volumeC

List files and directories at a path inside a volume.

Inputs: name (required), path, env_id, agent_token.

build_imageC

Build an image from Dockerfile content.

Inputs: dockerfile_content (required), tag, env_id, agent_token.

build_projectC

Build a Compose project's images.

Inputs: project_id (required), env_id, agent_token.

cancel_activityC

Cancel a running background activity.

Inputs: activity_id (required), env_id, agent_token.

check_all_image_updatesC

Check for updates on all images in the environment.

Inputs: env_id, agent_token.

check_image_updateC

Check if a newer version of an image is available by reference.

Inputs: reference (required), env_id, agent_token.

check_system_upgradeB

Check if a system upgrade is available for the given environment.

Inputs: env_id, agent_token.

classify_toolD

Return the classification label for a given tool classification value.

Inputs: action (required), classification.

clear_activity_historyC

Clear activity history for an environment. Requires confirmation via confirmation_token.

Inputs: env_id, dry_run, agent_token.

commit_containerC

Commit a container's current state to a new image.

Inputs: container_id (required), tag, repo, env_id, +1 more.

confirm_operationA

Confirm and execute a destructive operation.

Provide the confirmation_token that the earlier destructive tool call returned, and optionally the operation_hash for strongest safety. The token expires after 120 seconds.

When operation_hash is provided it MUST match the hash returned by the destructive tool. This prevents a token obtained for

remove_container("my-app")

from being used to execute

remove_container("other-app").

If the target resource supports it, the server will also check whether the resource has changed since the token was issued. If it has, the confirmation is denied.

Inputs: token (required), operation_hash.

connect_container_to_networkC

Connect a container to a network.

Inputs: network_id (required), container_id (required), env_id, agent_token.

create_containerB

Create and optionally start a container. Command is a string that will be split into an array (e.g. 'sleep 60' becomes ['sleep', '60']). For the raw array form use the JSON format for env/labels.

Inputs: name (required), image (required), env, env_id, +3 more.

create_environmentC

Register a new remote agent environment.

Inputs: name (required), api_url (required), agent_token (required).

create_networkC

Create a new network in the given environment.

Inputs: name (required), driver, env_id, agent_token.

create_registryC

Create a new container registry.

Inputs: url (required), name (required), env_id, password, +2 more.

create_volumeC

Create a new volume in the given environment.

Inputs: name (required), driver, env_id, labels, +1 more.

create_volume_backupC

Create a new backup of a volume.

Inputs: name (required), env_id, agent_token.

create_volume_directoryC

Create a directory inside a volume.

Inputs: name (required), path (required), env_id, agent_token.

create_webhookC

Create a new webhook in the given environment.

Inputs: url (required), name (required), env_id, agent_token.

delete_eventC

Delete a system event. Requires confirmation via confirmation_token.

Inputs: event_id (required), agent_token.

delete_registryA

Delete a container registry. Requires confirmation via confirmation_token.

Inputs: registry_id (required), env_id, agent_token.

delete_volume_backupA

Delete a volume backup. Destructive; requires confirmation token.

Inputs: backup_id (required), env_id, agent_token.

delete_volume_fileC

Delete a file or directory inside a volume. Destructive; requires confirmation token.

Inputs: name (required), path (required), env_id, agent_token.

delete_webhookA

Delete a webhook. Destructive; requires confirmation via confirmation_token.

Inputs: webhook_id (required), env_id, agent_token.

deploy_projectC

Deploy a new Compose project from compose content.

Inputs: project_name (required), compose_content (required), env_id, agent_token.

disconnect_container_from_networkC

Disconnect a container from a network.

Inputs: network_id (required), container_id (required), env_id, agent_token.

download_volume_backupC

Download a volume backup.

Inputs: backup_id (required), env_id, agent_token.

exec_in_containerB

Execute a command inside a running container. NOTE: The Arcane API does not expose a container exec endpoint. This tool will attempt to use SSH as a fallback if available, otherwise returns an error.

Inputs: command (required), container_id (required), env_id, agent_token.

get_activityC

Get a specific background activity.

Inputs: activity_id (required), env_id, agent_token.

get_container_countsC

Get container counts by status (running, stopped, paused, etc.).

Inputs: env_id, agent_token.

get_container_logsB

Fetch logs from a container. NOTE: The Arcane API may not expose a direct logs endpoint. If 404 is returned, use SSH to the Docker host as workaround.

Inputs: container_id (required), tail, env_id, agent_token.

get_container_statsB

Get live resource usage stats for a container. NOTE: The Arcane API may not expose a stats endpoint. If 404 is returned, use SSH to the Docker host as workaround.

Inputs: container_id (required), env_id, agent_token.

get_docker_infoC

Get Docker system information for the given environment.

Inputs: env_id, agent_token.

get_docker_versionC

Get Docker version for the given environment.

Inputs: env_id, agent_token.

get_environmentC

Get details of a specific environment.

Inputs: env_id (required).

get_environment_eventsC

Get events for a specific environment.

Inputs: environment_id (required), agent_token.

get_image_attestationsC

Get attestations for an image.

Inputs: name (required), env_id, agent_token.

get_image_countsC

Get image count statistics for the environment.

Inputs: env_id, agent_token.

get_image_exportB

Export an image by name (download its tar archive).

Inputs: name (required), env_id, agent_token.

get_image_historyC

Get the build history for an image.

Inputs: image_id (required), env_id, agent_token.

get_image_update_summaryC

Get a summary of available image updates.

Inputs: env_id, agent_token.

get_image_vulnerabilitiesC

Get vulnerability report for an image.

Inputs: image_id (required), env_id, agent_token.

get_network_countsC

Get network counts for the given environment.

Inputs: env_id, agent_token.

get_network_topologyC

Get network topology for the given environment.

Inputs: env_id, agent_token.

get_operation_statusA

Check whether a confirmation token is still valid without consuming it.

Returns the operation details (minus sensitive fields) or an error if the token is invalid or expired.

Inputs: token (required).

get_projectC

Get details of a specific Compose project.

Inputs: project_id (required), env_id, agent_token.

get_project_composeC

Get the Compose file content for a project.

Inputs: project_id (required), env_id, agent_token.

get_project_countsC

Get counts of Compose projects in the given environment.

Inputs: env_id, agent_token.

get_project_fileC

Get the project file content for a Compose project.

Inputs: project_id (required), env_id, agent_token.

get_project_runtimeC

Get the runtime info for a Compose project.

Inputs: project_id (required), env_id, agent_token.

get_registryB

Get a container registry by ID.

Inputs: registry_id (required), env_id, agent_token.

get_scanner_statusC

Get vulnerability scanner (Trivy) status.

Inputs: env_id, agent_token.

get_system_healthC

Get system health metrics for the given environment.

Inputs: env_id, agent_token.

get_updater_historyC

Get updater operation history.

Inputs: env_id, agent_token.

get_updater_statusC

Get the current updater status.

Inputs: env_id, agent_token.

get_volume_countsC

Get volume counts for the given environment.

Inputs: env_id, agent_token.

get_volume_sizesC

Get volume sizes for the given environment.

Inputs: env_id, agent_token.

get_volume_usageC

Get disk usage for a specific volume.

Inputs: name (required), env_id, agent_token.

get_vulnerability_summaryC

Get a summary of vulnerabilities for an image.

Inputs: image_id (required), env_id, agent_token.

get_vulnerability_summary_allC

Get vulnerability summary across all scanned images.

Inputs: env_id, agent_token.

ignore_vulnerabilityC

Ignore a specific vulnerability by URN.

Inputs: urn (required), env_id, agent_token.

inspect_containerC

Get detailed information about a specific container.

Inputs: container_id (required), env_id, agent_token.

inspect_imageC

Inspect image by id.

Inputs: image_id (required), env_id, agent_token.

inspect_networkC

Inspect a specific network.

Inputs: network_id (required), env_id, agent_token.

inspect_volumeC

Inspect a volume by name.

Inputs: name (required), env_id, agent_token.

kill_containerC

Force-kill a running container. Requires confirmation token to execute.

Inputs: container_id (required), env_id, agent_token.

list_activitiesB

List current and recent background activities for an environment.

Inputs: env_id, agent_token.

list_all_vulnerabilitiesC

List all vulnerabilities across the environment.

Inputs: env_id, agent_token.

list_containersC

List containers for a given Arcane environment.

Inputs: all, env_id, agent_token.

list_environmentsA

List all environments (local + remote agents).

Inputs: no named parameters.

list_eventsC

List system events (paginated, across all environments).

Inputs: agent_token.

list_ignored_vulnerabilitiesC

List all ignored vulnerabilities.

Inputs: env_id, agent_token.

list_imagesC

List all images in the given environment.

Inputs: env_id, agent_token.

list_networksA

List all networks in the given environment.

Inputs: env_id, agent_token.

list_portsC

List all port mappings for the given environment.

Inputs: env_id, agent_token.

list_projectsB

List all Compose projects in the given environment.

Inputs: env_id, agent_token.

list_registriesC

List all container registries.

Inputs: env_id, agent_token.

list_volume_backupsC

List all backups for a volume.

Inputs: name (required), env_id, agent_token.

list_volumesC

List all volumes in the given environment.

Inputs: env_id, agent_token.

list_webhooksC

List all webhooks for the given environment.

Inputs: env_id, agent_token.

pause_containerB

Pause a running container (freeze its processes).

Inputs: container_id (required), env_id, agent_token.

project_downC

Take a Compose project down (stop and remove containers).

Inputs: project_id (required), env_id, agent_token.

prune_imagesA

Prune unused Docker images. Destructive; use dry_run=False and confirmation token to execute.

When dry_run=True (default), returns a dry-run warning without creating a confirmation token. Set dry_run=False to get a confirmation token for execution.

Inputs: env_id, dry_run, agent_token.

prune_networksA

Prune unused Docker networks. Destructive; use dry_run=False and confirm to execute.

Inputs: env_id, dry_run, agent_token.

prune_systemA

Prune system resources for the given environment. Select what to prune via flags (containers, images, volumes, networks, build_cache). Volumes default to False. Use dry_run=True (default) to preview what would be pruned without making changes.

Inputs: env_id, images, dry_run, volumes, +4 more.

prune_volumesC

Prune unused Docker volumes. Destructive; use dry_run=False and confirm to execute.

Inputs: env_id, dry_run, agent_token.

pull_imageC

Pull image from registry into environment.

Inputs: repository (required), tag, env_id, agent_token.

pull_project_imagesC

Pull images for a Compose project.

Inputs: project_id (required), env_id, agent_token.

read_audit_logC

Read the last N lines of the audit log for destructive operations.

Inputs: lines, event_type.

read_volume_fileC

Read the contents of a file inside a volume.

Inputs: name (required), path (required), env_id, agent_token.

redeploy_containerC

Redeploy a container using its original image and configuration.

Inputs: container_id (required), env_id, agent_token.

redeploy_projectC

Redeploy a Compose project.

Inputs: project_id (required), env_id, agent_token.

remove_containerC

Remove a container. Requires confirmation token to execute.

Inputs: container_id (required), force, env_id, agent_token.

remove_environmentC

Remove an environment. Requires confirmation via confirmation_token.

Inputs: env_id (required).

remove_imageC

Remove image by id. Requires confirmation token to execute.

Inputs: image_id (required), force, env_id, agent_token.

remove_networkC

Remove a network. Destructive; requires confirmation token.

Inputs: network_id (required), env_id, agent_token.

remove_projectC

Remove a Compose project.

Inputs: project_id (required), env_id, agent_token.

remove_volumeB

Remove a volume by name. Destructive; requires confirmation token.

Inputs: name (required), force, env_id, agent_token.

restart_containerC

Restart a running container.

Inputs: container_id (required), env_id, timeout, agent_token.

restart_projectC

Restart a Compose project.

Inputs: project_id (required), env_id, agent_token.

restore_volume_backupB

Restore a volume backup. Destructive; requires confirmation token.

Inputs: backup_id (required), volume_name (required), env_id, agent_token.

run_updaterC

Run the updater to apply pending container updates. Requires confirmation via confirmation_token.

Inputs: env_id, agent_token.

scan_image_vulnerabilitiesC

Trigger a vulnerability scan on an image.

Inputs: image_id (required), env_id, agent_token.

search_imagesC

Search images by name/query in the environment.

Inputs: query (required), env_id, agent_token.

set_container_auto_updateC

Enable or disable automatic updates for a container.

Inputs: enabled (required), container_id (required), env_id, agent_token.

start_all_containersC

Start all stopped containers for the given environment.

Inputs: env_id, agent_token.

start_containerC

Start a stopped container.

Inputs: container_id (required), env_id, agent_token.

start_stopped_containersB

Start only containers that are currently stopped for the given environment.

Inputs: env_id, agent_token.

stop_all_containersC

Stop all running containers for the given environment.

Inputs: env_id, agent_token.

stop_containerC

Stop a running container gracefully.

Inputs: container_id (required), env_id, timeout, agent_token.

tag_imageC

Tag an existing image with a new repository name.

Inputs: source (required), target (required), env_id, agent_token.

test_registryC

Test connectivity to a container registry.

Inputs: registry_id (required), env_id, agent_token.

trigger_upgradeC

Trigger a system upgrade for the given environment.

Inputs: env_id, agent_token.

trigger_webhookC

Trigger an Arcane inbound webhook by token.

Inputs: token (required), action (required).

unarchive_projectC

Unarchive a Compose project.

Inputs: project_id (required), env_id, agent_token.

unignore_vulnerabilityB

Un-ignore a previously ignored vulnerability. Requires confirmation via confirmation_token.

Inputs: ignore_id (required), env_id, agent_token.

unpause_containerC

Unpause a paused container.

Inputs: container_id (required), env_id, agent_token.

update_containerB

Update a container's configuration (e.g. after image or resource changes).

Inputs: container_id (required), env_id, agent_token.

update_environmentA

Update environment settings (name, API URL, or access token).

Inputs: env_id (required), name, api_url, agent_token.

update_projectC

Update a Compose project's configuration.

Inputs: project_id (required), env_id, agent_token, project_name, +1 more.

update_project_servicesC

Update services of a Compose project from the current compose config.

Inputs: project_id (required), env_id, agent_token.

update_registryC

Update a container registry.

Inputs: registry_id (required), url, name, env_id, +3 more.

update_webhookC

Enable or disable a webhook.

Inputs: enabled (required), webhook_id (required), env_id, agent_token.

upload_imageC

Upload an image to the environment.

Note: This tool calls the upload endpoint but does NOT handle multipart file uploads. Use a direct API client (curl, Postman) with a multipart/form-data request for actual file uploads.

Inputs: env_id, agent_token.

upload_to_volumeC

Upload a file to a path inside a volume.

Inputs: name (required), path (required), content (required), env_id, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 127 tools

    Disambiguation4/5

    Despite the large number of tools, each tool clearly targets a specific resource and action (e.g., create_container vs. create_network). Descriptions further clarify intent. A few close pairs like check_image_update vs. check_all_image_updates exist but are distinguishable by scope.

    Naming Consistency5/5

    All tools use consistent snake_case with a verb_noun pattern (e.g., list_containers, start_container, prune_images). No mixing of conventions, making the naming predictable and easy to navigate.

    Tool Count2/5

    With 127 tools, the set is extremely large. While the server covers a broad domain (Docker management), the sheer number overwhelms typical agent decision-making and far exceeds the recommended range.

    Completeness5/5

    The tool surface covers nearly all aspects of Docker management: containers, images, volumes, networks, Compose projects, registries, webhooks, environments, vulnerabilities, and system operations. CRUD and lifecycle management are present for each resource, with only minor limitations noted (e.g., exec fallback).

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage Docker containers, images, networks, volumes, and Compose services through the Model Context Protocol. It supports system operations, command execution within containers, and integration with Docker Hub and GitHub Container Registry.
      167 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Exposes over 130 Dockhand API endpoints as tools to manage Docker infrastructure through AI assistants. It enables comprehensive control over containers, stacks, networks, and volumes across multiple environments and hosts.
      71
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides Docker management tools for AI agents, including inspecting containers, images, Dockerfiles, and Compose configurations.
      62 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables managing Docker environments through Arcane via natural language, providing tools for containers, images, volumes, networks, and Docker Compose stacks.
      MIT