Docker MCP 服务器

一个全面的模型上下文协议（MCP）服务器，通过统一接口提供高级的Docker操作。此服务器结合了16个强大的Docker MCP工具和25多个方便的命令行别名，为开发者、DevOps工程师和系统管理员创建了一个完整的Docker工作流解决方案。

🌟 Docker MCP 服务器的独特之处

Docker MCP 服务器不仅仅是一个Docker包装器——它是一个旨在使Docker操作更加直观、安全和高效的完整工作流增强系统：

🎯 统一接口

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

🔒 以安全为中心的设计

• Docker管理的安全性：所有密码操作由Docker守护进程处理，确保最大安全性
• 零密码暴露：密码不会出现在命令历史记录、进程列表或参数中
• 令牌认证支持：完全支持个人访问令牌和服务账户
• 注册表灵活性：安全登录到Docker Hub、AWS ECR、Azure ACR、Google GCR和自定义注册表
• CI/CD安全性：自动部署流水线中的安全标准输入密码输入
• 权限管理：正确处理Docker守护进程权限和凭证存储

🚀 开发者体验

• 全面的帮助系统：每个命令都包含详细的文档，可通过--help查看
• 智能默认设置：针对常见用例的合理默认配置
• 错误预防：内置的安全检查和破坏性操作确认提示
• 丰富的输出：格式化、彩色输出，带有清晰的状态指示器

📊 高级操作

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

📦 安装

简单安装（推荐）

全局安装Docker MCP服务器，以便在系统任何位置使用：

# 使用npm安装
npm install -g @0xshariq/docker-mcp-server

# 或者使用pnpm安装（更快）
pnpm add -g @0xshariq/docker-mcp-server

# 验证安装是否成功
docker-mcp-server --version
dlist                        # 列出所有可用命令

就这样！现在所有25个CLI别名都可以在整个系统中使用了。

开发者

如果您想贡献或定制服务器：

# 克隆并设置
git clone https://github.com/0xshariq/docker-mcp-server.git
cd docker-mcp-server
npm install
npm run build

# 本地测试
npm link                     # 使命令全局可用
dlist                       # 验证其是否正常工作

您需要首先准备

在安装之前，请确保您拥有：

• Node.js 18+ - 下载地址
• Docker - 安装Docker
• npm（随Node.js一起提供）

检查您是否已安装：

node --version              # 应显示v18或更高版本
docker --version           # 应显示Docker版本

🚀 快速开始

尝试一下

一旦安装完成，尝试这些命令来查看Docker MCP服务器的操作：

# 查看所有可用命令
dlist

# 基本Docker操作
dps                         # 列出正在运行的容器
dimages                     # 列出Docker镜像
drun -it ubuntu bash        # 运行交互式Ubuntu容器

# 高级操作
dcompose up -d              # 启动Docker Compose服务
dlogin                      # 登录到Docker注册表
dpublish myapp:v1.0         # 将镜像发布到注册表

📚 文档

了解更多：

• 📖 基本命令 - 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              # 自动环境设置
./start-mcp.sh --help       # 查看所有选项

兼容的客户端：Claude Desktop、Cursor IDE、Continue (VS Code)、Open WebUI等！

🏗️ 项目结构

docker-mcp-server/
├── src/                    # TypeScript源代码
├── bin/                    # CLI别名脚本
│   ├── basic/             # 8个基本Docker操作
│   └── advanced/          # 14个高级Docker操作
├── help/                  # 所有命令的文档
├── start-mcp.sh          # 通用MCP服务器启动脚本
├── docker-cli.js         # 主CLI封装
└── dist/                 # 编译后的JavaScript输出

📚 完整文档：

• 基本命令参考 - 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文件。

🔧 开发

对于贡献者

# 设置开发环境
git clone https://github.com/0xshariq/docker-mcp-server.git
cd docker-mcp-server
npm install

# 开发命令
npm run dev                 # 构建并监视更改
npm run build              # 构建TypeScript
npm run start              # 启动MCP服务器
npm run clean              # 清理构建文件

🧪 测试

快速测试

# 安装后，测试这些命令
dlist                      # 应该显示所有25个命令
dps                        # 应该列出容器
dimages                    # 应该列出镜像

测试MCP集成

./start-mcp.sh             # 应该无错误启动

🆘 常见问题

"命令未找到"

# 确保npm全局bin在您的PATH中
echo $PATH | grep $(npm config get prefix)

# 如果未找到，请将以下内容添加到~/.bashrc或~/.zshrc：
export PATH="$(npm config get prefix)/bin:$PATH"

"Docker守护进程未运行"

# 检查Docker状态
docker info

# 启动Docker（Linux）
sudo systemctl start docker

# 启动Docker Desktop（macOS/Windows）
# 启动Docker Desktop应用程序

"权限被拒绝"

# 将自己添加到docker组（Linux）
sudo usermod -aG docker $USER
# 然后注销并重新登录

📋 更多帮助：

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

---

📄 许可证

ISC许可证

👨‍💻 作者

Sharique Chaudhary (@0xshariq)

🤝 贡献

欢迎贡献！请：

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

🔗 链接

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

---

✨ Docker MCP服务器 - 让Docker工作流对每个人来说既简单又强大！