🚀 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
安装步骤
- 安装依赖
npm install
- 构建项目
npm run build
- 配置 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
注意事项
- 确保 Docker 守护进程正在运行
- 确保有正确的 Kubernetes 配置文件（默认位置：~/.kube/config）
- 确保有适当的集群访问权限
- 在使用 Pod 相关功能时，确保指定正确的命名空间和 Pod 名称
📄 许可证
MIT License
👨💻 作者
[Your Name]
📝 更新日志
1.0.0
- 初始版本发布
- 实现基本的 Docker 和 Kubernetes 操作功能
- 添加交互式 shell 支持