🐳 docker-mcp

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

✨ 特性

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

🎬 演示

部署 Docker Compose 堆栈

https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278

分析容器日志

https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934

🚀 快速开始

要在 Claude Desktop 应用程序中尝试此操作，请将其添加到您的 claude 配置文件中：

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

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Docker MCP：

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

前提条件

• UV (包管理器)
• Python 3.12+
• Docker Desktop 或 Docker Engine
• Claude Desktop

安装

Claude Desktop 配置

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

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

<details> <summary>💻 开发配置</summary>

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-docker-mcp>",
        "run",
        "docker-mcp"
      ]
    }
  }
}

</details>

<details> <summary>🚀 生产配置</summary>

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

</details>

🛠️ 开发

本地设置

1. 克隆存储库：

git clone https://github.com/QuantGeekDev/docker-mcp.git
cd docker-mcp

2. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 安装依赖项：

uv sync

🔍 调试

启动 MCP Inspector 进行调试：

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

Inspector 将提供一个 URL 来访问调试界面。

📝 可用工具

服务器提供以下工具：

create-container

创建独立的 Docker 容器

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

deploy-compose

部署 Docker Compose 堆栈

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

get-logs

从特定容器检索日志

{
    "container_name": "my-container"
}

list-containers

列出所有 Docker 容器

{}

🚧 当前限制

• 不支持容器的内置环境变量
• 没有卷管理
• 没有网络管理
• 没有容器健康检查
• 没有容器重启策略
• 没有容器资源限制

🤝 贡献

1. 从 docker-mcp Fork 存储库
2. 创建您的功能分支
3. 提交您的更改
4. 推送到分支
5. 打开拉取请求

📜 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

✨ 作者

• Alex Andru - 初始工作 | 核心贡献者 - @QuantGeekDev
• Ali Sadykov - 初始工作 | 核心贡献者 - @md-archive

---

用 ❤️ 制作