Docker MCP 快速开始指南

简介

Docker MCP 是一个强大的模型上下文协议服务器，通过 Claude AI 实现无缝容器和组合堆栈管理。

核心功能

🚀 容器创建与实例化
📦 Docker Compose 堆栈部署
🔍 容器日志检索
📊 容器状态监控

安装步骤

前提条件

UV（包管理器）
Python 3.12+
Docker Desktop/Engine
Claude Desktop

方法 1：通过 Smithery 安装（推荐）

npx @smithery/cli install docker-mcp --client claude

方法 2：手动配置

将服务器配置添加到 Claude Desktop 配置文件中：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

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

使用工具

创建容器

{
    "image": "image-name",
    "name": "container-name",
    "ports": {"80": "80"},
    "environment": {"ENV_VAR": "value"}
}

部署 Compose 堆栈

{
    "project_name": "example-stack",
    "compose_yaml": "version: '3.8'\nservices:\n  service1:\n    image: image1:latest\n    ports:\n      - '8080:80'"
}

获取日志

{
    "container_name": "my-container"
}

列出容器

{}

调试

启动 MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp

限制

目前不支持：环境变量、卷管理、网络管理、容器健康检查、重启策略、资源限制。

完整文档：GitHub 仓库

🐳 docker-mcp