Skip to main content
Glama
Arcane MCP
by 4ears-me

Arcane MCP

A Model Context Protocol (MCP) server for controlling Arcane Docker Management. This server provides comprehensive access to the Arcane API, enabling AI assistants to manage Docker containers, images, volumes, networks, and compose projects through the MCP protocol.

Features

  • Container Management: List, create, start, stop, restart, and delete containers

  • Image Management: List, pull, remove, and prune images

  • Volume Management: Full volume lifecycle including backups, restores, and file browsing

  • Network Management: Create, list, and remove Docker networks

  • Project/Compose Support: Deploy and manage Docker Compose projects

  • Environment Management: Multi-environment support with connection testing

  • System Monitoring: Health checks, version info, and system-wide operations

Related MCP server: mcp-server-docker

Prerequisites

  • Node.js 18 or higher

  • An Arcane instance running and accessible

  • Either an API key or username/password credentials for authentication

Installation

npm install
npm run build

Configuration

The server is configured via environment variables:

Variable

Required

Description

ARCANE_API_URL

Yes

Base URL of the Arcane API (e.g., https://arcane.example.com)

ARCANE_API_KEY

No*

API key for authentication

ARCANE_USERNAME

No*

Username for login

ARCANE_PASSWORD

No*

Password for login

*Either ARCANE_API_KEY or both ARCANE_USERNAME and ARCANE_PASSWORD must be provided.

Usage

npm start

For development with hot reload:

npm run dev

Integration with MCP Clients

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "arcane": {
      "command": "node",
      "args": ["/path/to/@4ears-me/arcane-mcp/dist/index.js"],
      "env": {
        "ARCANE_API_URL": "https://arcane.example.com",
        "ARCANE_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "arcane": {
      "command": "node",
      "args": ["/path/to/@4ears-me/arcane-mcp/dist/index.js"],
      "env": {
        "ARCANE_API_URL": "https://arcane.example.com",
        "ARCANE_API_KEY": "your-api-key"
      }
    }
  }
}

Using with npx

{
  "mcpServers": {
    "arcane": {
      "command": "npx",
      "args": ["-y", "@4ears-me/arcane-mcp"],
      "env": {
        "ARCANE_API_URL": "https://arcane.example.com",
        "ARCANE_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Environment Tools (6 tools)

Tool

Description

arcane_list_environments

List all environments with optional search filter

arcane_get_environment

Get details for a specific environment by ID

arcane_create_environment

Create a new environment

arcane_update_environment

Update an existing environment

arcane_delete_environment

Delete an environment by ID

arcane_test_environment

Test the connection to an environment

Container Tools (8 tools)

Tool

Description

arcane_list_containers

List containers in an environment

arcane_get_container

Get details of a specific container

arcane_create_container

Create a new container with full configuration options

arcane_start_container

Start a container

arcane_stop_container

Stop a container

arcane_restart_container

Restart a container

arcane_delete_container

Delete/remove a container

arcane_get_container_counts

Get container status counts for an environment

Image Tools (6 tools)

Tool

Description

arcane_list_images

List images in an environment

arcane_get_image

Get details of a specific image

arcane_pull_image

Pull an image from a registry

arcane_remove_image

Remove an image from the environment

arcane_prune_images

Prune unused images from the environment

arcane_get_image_counts

Get image usage counts for an environment

Volume Tools (11 tools)

Tool

Description

arcane_list_volumes

List all volumes in an environment

arcane_get_volume

Get details of a specific volume

arcane_create_volume

Create a new volume

arcane_remove_volume

Remove a volume from an environment

arcane_prune_volumes

Prune unused volumes in an environment

arcane_browse_volume

Browse files in a volume

arcane_get_volume_file

Get content of a file from a volume

arcane_get_volume_sizes

Get disk sizes for all volumes

arcane_list_volume_backups

List backups for a volume

arcane_create_volume_backup

Create a backup of a volume

arcane_restore_volume_backup

Restore a volume from a backup

Network Tools (5 tools)

Tool

Description

arcane_list_networks

List networks in an environment

arcane_get_network

Get details of a specific network

arcane_create_network

Create a new network

arcane_remove_network

Remove a network from an environment

arcane_prune_networks

Prune unused networks from an environment

Project Tools (11 tools)

Tool

Description

arcane_list_projects

List Docker Compose projects in an environment

arcane_get_project

Get details of a specific project

arcane_create_project

Create a new Docker Compose project

arcane_update_project

Update an existing project

arcane_delete_project

Delete/destroy a project

arcane_deploy_project

Deploy a project (docker-compose up)

arcane_stop_project

Stop/bring down a project

arcane_restart_project

Restart a project

arcane_redeploy_project

Redeploy a project

arcane_pull_project_images

Pull images for a project

arcane_get_project_counts

Get project status counts for an environment

System Tools (5 tools)

Tool

Description

arcane_get_system_info

Get Arcane system information

arcane_get_docker_info

Get Docker daemon information for an environment

arcane_prune_system

Perform system-wide prune on an environment

arcane_get_health

Check the health status of the Arcane API

arcane_get_version

Get the Arcane version information

Development

Command

Description

npm run build

Compile TypeScript to JavaScript

npm run dev

Run in development mode with tsx

npm start

Run the compiled server

License

MIT

Available Tools

52 tools
arcane_browse_volumeC

Browse files in a volume

Inputs: volumeName (required), environmentId (required), path.

arcane_create_containerB

Create a new container in an environment

Inputs: image (required), environmentId (required), env, name, +11 more.

arcane_create_environmentC

Create a new environment.

Inputs: url (required), name (required), description.

arcane_create_networkB

Create a new network in an environment

Inputs: name (required), environmentId (required), driver, labels, +2 more.

arcane_create_projectC

Create a new Docker Compose project

Inputs: name (required), composeFile (required), environmentId (required), path, +1 more.

arcane_create_volumeB

Create a new volume in an environment

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

arcane_create_volume_backupB

Create a backup of a volume

Inputs: volumeName (required), environmentId (required).

arcane_delete_containerC

Delete/remove a container

Inputs: containerId (required), environmentId (required).

arcane_delete_environmentB

Delete an environment by ID.

Inputs: id (required).

arcane_delete_projectC

Delete/destroy a Docker Compose project

Inputs: projectId (required), environmentId (required).

arcane_deploy_projectC

Deploy a Docker Compose project (docker-compose up)

Inputs: projectId (required), environmentId (required).

arcane_get_containerA

Get details of a specific container

Inputs: containerId (required), environmentId (required).

arcane_get_container_countsC

Get container status counts for an environment

Inputs: environmentId (required).

arcane_get_docker_infoA

Get Docker daemon information for a specific environment

Inputs: environmentId (required).

arcane_get_environmentA

Get details for a specific environment by ID.

Inputs: id (required).

arcane_get_healthA

Check the health status of the Arcane API

Inputs: no named parameters.

arcane_get_imageC

Get details of a specific image

Inputs: imageId (required), environmentId (required).

arcane_get_image_countsB

Get image usage counts for an environment

Inputs: environmentId (required).

arcane_get_networkB

Get details of a specific network

Inputs: networkId (required), environmentId (required).

arcane_get_projectC

Get details of a specific Docker Compose project

Inputs: projectId (required), environmentId (required).

arcane_get_project_countsB

Get Docker Compose project status counts for an environment

Inputs: environmentId (required).

arcane_get_system_infoA

Get Arcane system information including version, uptime, and resource counts

Inputs: no named parameters.

arcane_get_versionA

Get the Arcane version information

Inputs: no named parameters.

arcane_get_volumeC

Get details of a specific volume

Inputs: volumeName (required), environmentId (required).

arcane_get_volume_fileA

Get content of a file from a volume

Inputs: filePath (required), volumeName (required), environmentId (required).

arcane_get_volume_sizesA

Get disk sizes for all volumes in an environment

Inputs: environmentId (required).

arcane_list_containersB

List containers in an environment

Inputs: environmentId (required), search.

arcane_list_environmentsA

List all environments. Optionally filter by search term.

Inputs: search.

arcane_list_imagesB

List images in an environment

Inputs: environmentId (required), search.

arcane_list_networksB

List networks in an environment

Inputs: environmentId (required), search.

arcane_list_projectsA

List Docker Compose projects in an environment

Inputs: environmentId (required), search.

arcane_list_volume_backupsC

List backups for a volume

Inputs: volumeName (required), environmentId (required).

arcane_list_volumesA

List all volumes in an environment

Inputs: environmentId (required), search.

arcane_prune_imagesB

Prune unused images from the environment

Inputs: environmentId (required).

arcane_prune_networksB

Prune unused networks from an environment

Inputs: environmentId (required).

arcane_prune_systemC

Perform system-wide prune on an environment to clean up unused resources

Inputs: environmentId (required).

arcane_prune_volumesB

Prune unused volumes in an environment

Inputs: environmentId (required).

arcane_pull_imageC

Pull an image from a registry

Inputs: image (required), environmentId (required), tag, platform, +1 more.

arcane_pull_project_imagesC

Pull images for a Docker Compose project

Inputs: projectId (required), environmentId (required).

arcane_redeploy_projectC

Redeploy a Docker Compose project

Inputs: projectId (required), environmentId (required).

arcane_remove_imageB

Remove an image from the environment

Inputs: imageId (required), environmentId (required).

arcane_remove_networkB

Remove a network from an environment

Inputs: networkId (required), environmentId (required).

arcane_remove_volumeC

Remove a volume from an environment

Inputs: volumeName (required), environmentId (required).

arcane_restart_containerC

Restart a container

Inputs: containerId (required), environmentId (required).

arcane_restart_projectC

Restart a Docker Compose project

Inputs: projectId (required), environmentId (required).

arcane_restore_volume_backupB

Restore a volume from a backup

Inputs: backupId (required), volumeName (required), environmentId (required).

arcane_start_containerC

Start a container

Inputs: containerId (required), environmentId (required).

arcane_stop_containerC

Stop a container

Inputs: containerId (required), environmentId (required).

arcane_stop_projectB

Stop/bring down a Docker Compose project

Inputs: projectId (required), environmentId (required).

arcane_test_environmentC

Test the connection to an environment.

Inputs: id (required).

arcane_update_environmentC

Update an existing environment.

Inputs: id (required), url, name, description.

arcane_update_projectC

Update an existing Docker Compose project

Inputs: projectId (required), environmentId (required), name, path, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 52 tools

    Disambiguation5/5

    Each tool targets a distinct resource-action combination, with clear separation across environments, containers, images, volumes, networks, projects, and system operations. Even similar prune operations are differentiated by the resource type (images, volumes, networks, system).

    Naming Consistency5/5

    All 52 tools follow the exact pattern 'arcane_<verb>_<noun>' in lowercase snake_case, with verbs always placed first (e.g., list, get, create, update, delete, start, stop, prune). No mixed styles or inconsistent verb usage.

    Tool Count3/5

    At 52 tools, the count is high and exceeds typical thresholds, but the server's scope is broad, covering full lifecycle management for multiple resource types. The number feels heavy but justified; some consolidation could reduce it without losing functionality.

    Completeness4/5

    The tool surface provides robust CRUD and lifecycle coverage for all major resource types, including specialized features like volume backups and file browsing. Minor gaps exist (e.g., container logs, network connect), but these do not hinder core container management workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    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.
      154 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      AI-powered Docker management server that enables natural language control of environments, containers, images, networks, volumes, and more through a unified Arcane API interface.
      2
      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