MCP-Server VBox

基本能力

产品定位

MCP-Server VBox 是一个用于管理和操作 Docker 容器和 Kubernetes 集群的工具，提供统一的接口来简化容器和 Pod 的操作。

核心功能

1. Docker 操作
2. 列出所有容器（docker_list_containers）
3. 拉取 Docker 镜像（docker_pull_image）

4. 创建新容器（docker_create_container）

5. Kubernetes 操作

6. 列出指定命名空间的 Pod（k8s_list_pods）
7. 创建 Deployment（k8s_create_deployment）
8. 在 Pod 中执行命令（k8s_exec_pod）
9. 进入 Pod 的交互式 shell（k8s_enter_pod）

10. 退出 Pod 的执行环境（k8s_exit_pod）

11. 执行环境管理

12. 获取当前执行环境（get_execution_context）
13. 在当前环境执行命令（execute_command）
14. 支持本地和 Pod 两种执行环境
15. 实时命令执行和输出

适用场景

• 开发人员需要快速管理和操作 Docker 容器
• 运维人员需要高效管理 Kubernetes 集群
• 团队需要统一的接口来简化容器和 Pod 的操作

工具列表

• docker_list_containers：列出所有 Docker 容器
• docker_pull_image：拉取 Docker 镜像
• docker_create_container：创建新容器
• k8s_list_pods：列出指定命名空间的 Pod
• k8s_create_deployment：创建 Deployment
• k8s_exec_pod：在 Pod 中执行命令
• k8s_enter_pod：进入 Pod 的交互式 shell
• k8s_exit_pod：退出 Pod 的执行环境
• get_execution_context：获取当前执行环境
• execute_command：在当前环境执行命令

常见问题解答

1. Docker 守护进程未运行
2. 确保 Docker 守护进程正在运行
3. Kubernetes 配置文件缺失
4. 确保有正确的 Kubernetes 配置文件（默认位置：~/.kube/config）
5. 集群访问权限不足
6. 确保有适当的集群访问权限
7. Pod 相关功能无法使用
8. 确保指定正确的命名空间和 Pod 名称

使用教程

使用依赖

1. 安装 Node.js bash brew install node
2. 安装 Docker bash brew install docker
3. 配置 Kubernetes 集群
4. 确保 ~/.kube/config 文件存在并正确配置

安装教程

1. 安装依赖 bash npm install
2. 构建项目 bash npm run build
3. 配置 Claude Desktop
4. 在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加以下配置： json { "mcpServers": { "vbox": { "command": "node", "args": [ "/path/to/your/vbox/build/index.js" ] } } }
5. 注意：将 /path/to/your/vbox 替换为实际的项目路径

调试方式

1. 添加调试选项
2. 在 Claude Desktop 配置中添加调试选项： json { "mcpServers": { "vbox": { "command": "node", "args": [ "--inspect", "/path/to/your/vbox/build/index.js" ], "debug": true } } }
3. 查看日志
4. MCP 服务器日志：~/Library/Logs/Claude/mcp-server-vbox.log
5. Claude Desktop 日志：~/Library/Logs/Claude/mcp.log

许可证

该项目遵循 MIT 开源许可条款。