Arcane MCP
Manages Docker containers, images, volumes, networks, and Docker Compose projects through the Arcane API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Arcane MCP list running containers in default environment"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildConfiguration
The server is configured via environment variables:
Variable | Required | Description |
| Yes | Base URL of the Arcane API (e.g., |
| No* | API key for authentication |
| No* | Username for login |
| No* | Password for login |
*Either ARCANE_API_KEY or both ARCANE_USERNAME and ARCANE_PASSWORD must be provided.
Usage
npm startFor development with hot reload:
npm run devIntegration 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 |
| List all environments with optional search filter |
| Get details for a specific environment by ID |
| Create a new environment |
| Update an existing environment |
| Delete an environment by ID |
| Test the connection to an environment |
Container Tools (8 tools)
Tool | Description |
| List containers in an environment |
| Get details of a specific container |
| Create a new container with full configuration options |
| Start a container |
| Stop a container |
| Restart a container |
| Delete/remove a container |
| Get container status counts for an environment |
Image Tools (6 tools)
Tool | Description |
| List images in an environment |
| Get details of a specific image |
| Pull an image from a registry |
| Remove an image from the environment |
| Prune unused images from the environment |
| Get image usage counts for an environment |
Volume Tools (11 tools)
Tool | Description |
| List all volumes in an environment |
| Get details of a specific volume |
| Create a new volume |
| Remove a volume from an environment |
| Prune unused volumes in an environment |
| Browse files in a volume |
| Get content of a file from a volume |
| Get disk sizes for all volumes |
| List backups for a volume |
| Create a backup of a volume |
| Restore a volume from a backup |
Network Tools (5 tools)
Tool | Description |
| List networks in an environment |
| Get details of a specific network |
| Create a new network |
| Remove a network from an environment |
| Prune unused networks from an environment |
Project Tools (11 tools)
Tool | Description |
| List Docker Compose projects in an environment |
| Get details of a specific project |
| Create a new Docker Compose project |
| Update an existing project |
| Delete/destroy a project |
| Deploy a project (docker-compose up) |
| Stop/bring down a project |
| Restart a project |
| Redeploy a project |
| Pull images for a project |
| Get project status counts for an environment |
System Tools (5 tools)
Tool | Description |
| Get Arcane system information |
| Get Docker daemon information for an environment |
| Perform system-wide prune on an environment |
| Check the health status of the Arcane API |
| Get the Arcane version information |
Development
Command | Description |
| Compile TypeScript to JavaScript |
| Run in development mode with tsx |
| Run the compiled server |
License
MIT
Available Tools
52 toolsarcane_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
Scored across 52 tools
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).
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.
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.
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
Related MCP Connectors
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Manage your own cloud with AI: deploy apps, push and ship custom Docker images, manage resources via your AI agent.
Hosting for AI agents: your AI client deploys Docker apps to live HTTPS URLs over MCP.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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 npm2MIT
- AlicenseAqualityDmaintenanceDocker container, image, volume, network, and compose management from your AI assistant.101,176 npm4MIT
- AlicenseNot gradedqualityAmaintenanceAI-powered Docker management server that enables natural language control of environments, containers, images, networks, volumes, and more through a unified Arcane API interface.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables managing Docker environments through Arcane via natural language, providing tools for containers, images, volumes, networks, and Docker Compose stacks.MIT