Docker Mcp Server

Docker MCP Server

一个全面的模型上下文协议（MCP）服务，通过统一接口提供高级 Docker 操作。该服务将 16 种强大的 Docker MCP 工具与 25 多个便捷的 CLI 别名相结合，为开发者、DevOps 工程师和系统管理员打造完整的 Docker 工作流解决方案。

🌟 Docker MCP Server 的特别之处

Docker MCP Server 不只是另一个 Docker 封装工具，而是一个完整的 Docker 工作流增强系统，旨在让 Docker 操作更直观、安全、高效：

🎯 统一接口

• MCP 协议集成：可与兼容 MCP 的工具和 IDE 无缝协作
• CLI 便利性：为常见 Docker 工作流精心设计了 25 多个别名
• 一致的 API：所有操作都遵循相同的模式和约定
• 跨平台：全面支持 Linux、macOS 和 Windows 环境

🔒 安全优先设计

• Docker 管理安全性：所有密码操作均由 Docker 守护进程处理，确保最高安全性
• 密码零泄露：密码绝不会出现在命令历史记录、进程列表或参数中
• 令牌身份验证支持：全面支持个人访问令牌和服务账户
• 灵活的镜像仓库：可安全登录 Docker Hub、AWS ECR、Azure ACR、Google GCR 和自定义镜像仓库
• CI/CD 安全性：支持通过标准输入安全输入密码，用于自动化部署流水线
• 权限管理：妥善处理 Docker 守护进程权限和凭据存储

🚀 开发者体验

• 全面的帮助系统：每条命令都提供详细文档，可使用 --help 查看
• 智能默认值：针对常见用例提供合理的默认配置
• 防止错误：内置安全检查，并在执行破坏性操作前进行确认
• 丰富的输出：提供格式清晰、带颜色的输出和明确的状态指示

📊 高级操作

• 完整的容器生命周期：从构建到发布，全面支持镜像仓库
• 多容器管理：集成 Docker Compose，实现服务编排
• 镜像仓库发布：高级镜像发布功能，支持多平台和自动化工作流
• 网络与卷管理：高级网络和存储操作
• 系统维护：提供多种安全级别的智能清理工具
• 开发工作流：为开发环境提供专用命令

📦 安装

MCP 客户端快速配置

将此配置添加到 MCP 客户端设置中：

{
  "mcpServers": {
    "docker-mcp-server": {
      "command": "npx",
      "args": ["-y", "@0xshariq/docker-mcp-server@latest"]
    }
  }
}

添加位置：

• Claude Desktop：claude_desktop_config.json
• VS Code Cline：.vscode/mcp.json
• 其他 MCP 客户端：查看相应客户端的配置文档

简易安装（推荐）

全局安装 Docker MCP Server，即可在系统的任何位置使用：

# Install with npm
npm install -g @0xshariq/docker-mcp-server

# Or install with pnpm (faster)
pnpm add -g @0xshariq/docker-mcp-server

# Verify installation works
docker-mcp-server --version
dlist                        # List all available commands

完成！现在，所有 25 个 CLI 别名均可在整个系统中使用。

面向开发者

如果你想为该服务贡献代码或进行自定义：

# Clone and setup
git clone https://github.com/0xshariq/docker-mcp-server.git
cd docker-mcp-server
npm install
npm run build

# Test locally
npm link                     # Makes commands available globally
dlist                       # Verify it works

所需准备

安装前，请确保已准备好：

• Node.js 18+ - 在此下载
• Docker - 安装 Docker
• npm（随 Node.js 一同安装）

检查是否已安装：

node --version              # Should show v18 or higher
docker --version           # Should show Docker version

🚀 快速开始

试用

安装后，试试以下命令，了解 Docker MCP Server 的运行方式：

# See all available commands
dlist

# Basic Docker operations
dps                         # List running containers
dimages                     # List Docker images
drun -it ubuntu bash        # Run interactive Ubuntu container

# Advanced operations
dcompose up -d              # Start Docker Compose services
dlogin                      # Login to Docker registries
dpublish myapp:v1.0         # Publish image to registry

📚 文档

了解更多：

• 📖 基本命令 - 轻松完成 8 项必备 Docker 操作
• ⚡ 高级命令 - 14 个强大的工具，助力复杂工作流
• 🔧 MCP 服务配置 - 与 Claude Desktop 和其他 MCP 客户端连接

🎯 你将获得

基本命令（8 个别名）

简单实用、开箱即用的日常 Docker 操作：

• 容器管理：列出、运行、停止和检查容器
• 镜像操作：拉取、构建和管理 Docker 镜像
• 日志与调试：查看日志并在容器内执行命令

高级命令（14 个别名）

用于复杂 Docker 工作流的强大工具：

• 多容器应用：完整集成 Docker Compose
• 镜像仓库操作：安全登录并将镜像发布到 Docker Hub、GitHub、AWS 等平台
• 网络与存储：高级网络和卷管理
• 系统维护：智能清理和环境管理
• 开发工具：适用于开发环境的专用工作流

🔧 MCP 服务配置

适用于 Claude Desktop

1. 找到你的 Claude 配置文件：

   • Linux：~/.config/claude-desktop/claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 将以下内容添加到配置中：

   {
     "mcpServers": {
       "docker": {
         "command": "node",
         "args": ["/path/to/docker-mcp-server/dist/index.js"]
       }
     }
   }
   

3. 重启 Claude Desktop，即可使用 Docker 工具！

通用启动脚本

使用我们的启动脚本，即可自动配置任何 MCP 客户端：

./start-mcp.sh              # Automatic environment setup
./start-mcp.sh --help       # See all options

兼容： Claude Desktop、Cursor IDE、Continue（VS Code）、Open WebUI 等！

🏗️ 项目结构

docker-mcp-server/
├── src/                    # TypeScript source code
├── bin/                    # CLI alias scripts
│   ├── basic/             # 8 basic Docker operations
│   └── advanced/          # 14 advanced Docker operations
├── help/                  # Documentation for all commands
├── start-mcp.sh          # Universal MCP server startup script
├── docker-cli.js         # Main CLI wrapper
└── dist/                 # Compiled JavaScript output

📚 完整文档：

• 基本命令参考 - 8 项必备 Docker 操作
• 高级命令参考 - 14 个强大的工作流工具
• 所有可用命令 - 完整的语法和示例

⚡ 所有可用命令

基本操作（8 个命令）

日常使用必备的 Docker 操作：

• dimages、dps、dpsa、dpull、drun、dlogs、dexec、dbuild

高级操作（14 个命令）

用于复杂工作流的强大工具：

• dcompose、dup、ddown、dnetwork、dvolume、dinspect、dprune
• dlogin、dlogout、dpublish、dbridge、ddev、dclean、dstop、dreset

实用工具命令（3 个命令）

• docker-mcp-server、dms、dlist

📖 查看详细文档： 使用 dlist 命令，或查看上方链接的 README 文件。

🔧 开发

贡献者指南

# Setup development environment
git clone https://github.com/0xshariq/docker-mcp-server.git
cd docker-mcp-server
npm install

# Development commands
npm run dev                 # Build and watch for changes
npm run build              # Build TypeScript
npm run start              # Start MCP server
npm run clean              # Clean build files

🧪 测试

快速测试

# After installation, test these commands
dlist                      # Should show all 25 commands
dps                        # Should list containers
dimages                    # Should list images

测试 MCP 集成

./start-mcp.sh             # Should start without errors

🆘 常见问题

“找不到命令”

# Make sure npm global bin is in your PATH
echo $PATH | grep $(npm config get prefix)

# If not found, add this to ~/.bashrc or ~/.zshrc:
export PATH="$(npm config get prefix)/bin:$PATH"

“Docker 守护进程未运行”

# Check Docker status
docker info

# Start Docker (Linux)
sudo systemctl start docker

# Start Docker Desktop (macOS/Windows)
# Launch the Docker Desktop app

“权限被拒绝”

# Add yourself to docker group (Linux)
sudo usermod -aG docker $USER
# Then logout and login again

📋 更多帮助：

• 查看 dlist --help，了解所有命令
• 查看故障排除指南，获取详细解决方案

---

📄 许可证

ISC 许可证

👨‍💻 作者

Sharique Chaudhary（@0xshariq）

🤝 贡献

欢迎贡献！请：

1. Fork 此仓库
2. 创建功能分支
3. 测试你的更改
4. 提交拉取请求

🔗 链接

• GitHub 仓库
• NPM 包
• 问题与支持

---

✨ Docker MCP Server - 让每个人都能轻松高效地使用 Docker 工作流！