MCP-Server VBox

MCP-Server VBox 是一个基于 Model Context Protocol (MCP) 的服务器实现，用于管理和操作 Docker 容器和 Kubernetes 集群。该工具提供了一个统一的接口，让您可以通过 Claude Desktop 方便地执行容器和 Pod 相关的操作。

功能特点

Docker 操作

• 列出所有容器（docker_list_containers）
• 拉取 Docker 镜像（docker_pull_image）
• 创建新容器（docker_create_container）

Kubernetes 操作

• 列出指定命名空间的 Pod（k8s_list_pods）
• 创建 Deployment（k8s_create_deployment）
• 在 Pod 中执行命令（k8s_exec_pod）
• 进入 Pod 的交互式 shell（k8s_enter_pod）
• 退出 Pod 的执行环境（k8s_exit_pod）

执行环境管理

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

系统要求

• Node.js >= 14.0.0
• Docker
• Kubernetes 集群配置（~/.kube/config）
• Claude Desktop

安装和配置

1. 安装依赖

npm install

2. 构建项目

npm run build

3. 配置 Claude Desktop

在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加以下配置：

{
    "mcpServers": {
        "vbox": {
            "command": "node",
            "args": [
                "/path/to/your/vbox/build/index.js"
            ]
        }
    }
}

注意：请将 /path/to/your/vbox 替换为实际的项目路径。

调试

如果需要调试，可以在 Claude Desktop 配置中添加调试选项：

{
    "mcpServers": {
        "vbox": {
            "command": "node",
            "args": [
                "--inspect",
                "/path/to/your/vbox/build/index.js"
            ],
            "debug": true
        }
    }
}

日志文件位置：

• MCP 服务器日志：~/Library/Logs/Claude/mcp-server-vbox.log
• Claude Desktop 日志：~/Library/Logs/Claude/mcp.log

注意事项

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

许可证

MIT License

作者

[Your Name]

更新日志

1.0.0

• 初始版本发布
• 实现基本的 Docker 和 Kubernetes 操作功能
• 添加交互式 shell 支持