Docker Compose

🐋 Docker MCP Server

A natural language MCP server for Docker management!

🚀 Quick Start

Installation

Using Claude Desktop

On MacOS: ~/Library/Application\ 支持/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json%

"mcpServers": {
  "mcp-server-docker": {
    "command": "uvx",
    "args": [
      "mcp-server-docker"
    ]
  }
}

docker build -t mcp-server-docker .

"mcpServers": {
  "mcp-server-docker": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-v",
      "/var/run/docker.sock:/var/run/docker.sock",
      "mcp-server-docker"
    ]
  }
}

✨ Features

• 🚀 Deploy containers using natural language.
• 🔍 Check and debug running containers.
• 📀 Manage persistent data in Docker volumes.

🎯 Target Audience

• Server administrators: Connect to a remote Docker engine, e.g., manage publicly facing internet websites.
• Curious individuals: Run containers locally and experiment with open - source Docker - supported applications.
• AI enthusiasts: Explore the limit capabilities of LLMs!

🎥 Demo

Example of quickly deploying WordPress using natural language:

https://github.com/user-attachments/assets/65e35e67-bce0-4449-af7e-9f4dd773b4b3

💡 Usage Tips

• Use docker ps to list all running containers.
• Use docker stop <container_id> to stop a specified container.
• Use docker rm <container_id> to remove a specified container.

🛠️ Resources

• This server uses the from_env method of the Python Docker SDK. For configuration details, refer to the Documentation.

💻 Development

It is recommended to use Devbox to configure the development environment. Check devbox.json for useful development commands. After setting up Devbox, you can configure Claude MCP as follows:

  "docker": {
    "command": "/path/to/repo/.devbox/nix/profile/default/bin/uv",
    "args": [
      "--directory",
      "/path/to/repo/",
      "run",
      "mcp-server-docker"
    ]
  },

⚠️ Important Note

• Sensitive data: Be cautious when handling containers. Docker is not a secure sandbox environment. The MCP server does not support high - risk options such as --privileged or --cap-add/--cap-drop.
• Container review: Carefully review the generated containers before deployment to ensure their security.

With the above steps, you can easily use the Docker MCP server to manage your containers and enjoy the convenience of natural language interaction!