JinDaGe - build-mcp MCP Details

article

README

🚀 Docker Build MCP TypeScript Server

本项目是一个完全遵循 MCP（模型上下文协议）标准的 Docker Build MCP 服务器。它能为用户提供标准化、自动化的 Docker 镜像管理服务，借助 MCP 标准实现与各类客户端的无缝对接，极大提升 Docker 操作的便捷性与效率。

✨ 主要特性

💯 完全支持 MCP 标准：与 Cursor、Claude 等 MCP 客户端在工具发现和执行方面 100% 兼容。
⚙️ 自动化 Docker 镜像管理：通过 API 提供 build、run、stop、rm、rmi、push 等 Docker CLI 的主要功能。
📡 支持 SSE（服务器发送事件）和 stdio 模式。
🔧 高扩展性结构：每个 Docker 命令都作为独立工具实现，便于维护和扩展。
📝 执行命令和结果日志：执行所有 Docker 命令时，命令和结果会输出到控制台。

📂 目录结构

./
  ├── dist/                # 构建结果
  ├── node_modules/        # 依赖模块
  ├── src/
  │   ├── config/          # 服务器和工具配置
  │   ├── models/          # 类型/模式定义
  │   ├── prompts/         # MCP 提示处理程序
  │   ├── resources/       # 资源处理程序
  │   ├── tools/           # 与 Docker 相关的 MCP 工具 (build, run, stop, rm, rmi 等)
  │   ├── utils/           # 实用函数
  │   ├── http-server.ts   # HTTP 服务器入口点
  │   └── index.ts         # MCP 服务器入口点
  ├── tests/               # 测试代码
  ├── package.json         # 项目元数据/脚本
  ├── tsconfig.json        # TypeScript 配置
  └── vitest.config.ts     # 测试配置

💪 主要功能和支持工具

docker_build：接收多个文件作为上下文，构建 Docker 镜像。
docker_run：使用所需选项创建并运行容器。
docker_ps：查询正在运行/所有容器的列表（支持 all 选项）。
docker_stop, docker_stop_multi：停止容器（多个）。
docker_rm, docker_rm_multi：删除容器（多个）（删除前自动停止）。
docker_images：查询本地镜像列表。
docker_rmi, docker_rmi_multi：删除镜像（多个）。
docker_push：将标记的镜像推送到注册表。
docker_login：登录 Docker 注册表。
docker-inspect：查询容器/镜像的详细信息。
docker-container-prune, docker-image-prune, docker-network-prune, docker-volume-prune：批量清理不必要的资源。

📦 安装指南

1. 安装依赖

npm install

2. 运行开发服务器（SSE 模式）

ENABLE_UNSAFE_SSE_TRANSPORT=1 npm run dev

3. 构建并部署运行

npm run build
npm start

💻 使用示例

基础用法

MCP 客户端可以通过工具发现自动识别和执行上述工具。
每个工具通过子进程直接调用 Docker CLI，与实际 Docker 环境的操作相同。

🧪 测试

tests/ 目录中包含每个工具的测试代码。
支持基于 vitest 的测试。

🤝 贡献与咨询

本项目欢迎扩展和贡献。如果您有关于 MCP 标准、Docker 自动化或额外功能的问题，请随时通过 Issue 或 PR 提出。

实际上，build、push、run 等操作是通过子进程调用 Docker CLI 完成的。

🐳 DinD（Docker 内 Docker）完全隔离型 MCP 服务器实战部署指南

1. 构建最新镜像并推送到 Docker Hub

docker build -t ekdh600/build-mcp:latest .
docker push ekdh600/build-mcp:latest

2. 提交并推送最新代码到 Git

cd docker-build-mcp-ts
git add .
git commit -m "docs: 更新 DinD 结构和 Kubernetes 支持"
git push

3. 基于 DinD 运行完全隔离的容器（适配 Kubernetes）

不挂载主机 Docker 套接字，仅使用内部 dockerd
在 Kubernetes 环境中也能正常工作

docker run --privileged --name build-mcp -d -p 3000:3000 ekdh600/build-mcp:latest

内部 dockerd 会自动启动，MCP 服务器在 0.0.0.0:3000 监听。
MCP 工具（docker_ps、docker_run 等）仅控制容器内部的 Docker 环境（与主机完全隔离）。
可以在 Cursor、云环境或 Kubernetes 环境中注册并使用 MCP 服务器。

4. MCP 工具实战使用示例（Cursor/云环境）

MCP 服务器地址：http://<主机 IP>:3000
在 Cursor 中注册 MCP 服务器后，即可使用 docker_ps、docker_run 等工具。
创建和查询的容器都仅存在于 DinD 内部环境中。

build-mcp