docker-mcp

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables container and Docker Compose stack management, including creation of standalone containers, deployment of compose stacks, retrieval of container logs, and listing of container status and information.

🐳docker-mcp

用于 Docker 操作的强大的模型上下文协议 (MCP) 服务器,通过 Claude AI 实现无缝容器和组合堆栈管理。

✨ 特点

  • 🚀 容器创建和实例化
  • 📦 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 Desktop 安装 Docker MCP:

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

先决条件

  • UV(包管理器)
  • Python 3.12+
  • Docker 桌面或 Docker 引擎
  • 克劳德桌面

安装

Claude桌面配置

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

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

{ "mcpServers": { "docker-mcp": { "command": "uv", "args": [ "--directory", "<path-to-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
  1. 创建并激活虚拟环境:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
  1. 安装依赖项:
uv sync

🔍 调试

启动 MCP Inspector 进行调试:

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

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

📝 可用工具

该服务器提供以下工具:

创建容器

创建独立的 Docker 容器

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

部署-撰写

部署 Docker 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" }

列表容器

列出所有 Docker 容器

{}

🚧 当前限制

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

🤝 贡献

  1. docker-mcp fork 仓库
  2. 创建你的功能分支
  3. 提交你的更改
  4. 推送到分支
  5. 打开拉取请求

📜 许可证

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

✨ 作者


用❤️制作

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

用于 Docker 操作的强大的模型上下文协议 (MCP) 服务器,通过 Claude AI 实现无缝容器和组合堆栈管理。

  1. ✨ Features
    1. 🎬 Demos
  2. 🚀 Quickstart
    1. Installing via Smithery
    2. Prerequisites
    3. Installation
  3. 🛠️ Development
    1. Local Setup
    2. 🔍 Debugging
  4. 📝 Available Tools
    1. create-container
    2. deploy-compose
    3. get-logs
    4. list-containers
  5. 🚧 Current Limitations
    1. 🤝 Contributing
      1. 📜 License
        1. ✨ Authors
          ID: 8tdzip0z5a