🐳 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桌面应用中试用，请将以下配置添加到claude配置文件中：

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

通过Smithery安装

使用Smithery为Claude桌面版自动安装Docker MCP：

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

先决条件

• UV包管理器
• Python 3.12+
• Docker Desktop或Docker Engine
• Claude桌面版

安装指南

Claude桌面版配置

将服务器配置添加到Claude桌面版配置文件中：

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

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

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

🛠️ 开发指南

本地环境搭建

1. 克隆仓库：

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

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

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

3. 安装依赖：

uv sync

🔍 调试方法

启动MCP检查器进行调试：

npx @modelcontextprotocol/inspector uv --directory <docker-mcp路径> run docker-mcp

检查器将提供访问调试界面的URL。

📝 可用工具

服务器提供以下工具：

create-container

创建独立Docker容器

{
    "image": "镜像名称",
    "name": "容器名称",
    "ports": {"80": "80"},
    "environment": {"ENV_VAR": "值"}
}

deploy-compose

部署Docker Compose堆栈

{
    "project_name": "示例堆栈",
    "compose_yaml": "version: '3.8'\nservices:\n  service1:\n    image: image1:latest\n    ports:\n      - '8080:80'"
}

get-logs

获取指定容器日志

{
    "container_name": "我的容器"
}

list-containers

列出所有Docker容器

{}

🚧 当前限制

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

🤝 参与贡献

1. 从docker-mcp fork仓库
2. 创建您的功能分支
3. 提交变更
4. 推送分支
5. 发起Pull Request

📜 开源协议

本项目采用MIT许可证 - 详见LICENSE文件。

✨ 作者名单

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

用❤️打造