MCP-Server VBox
MCP server for enabling AI use local k8s resources
Wan-Hao
README
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 支持
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
MCP Package Docs Server
Facilitates LLMs to efficiently access and fetch structured documentation for packages in Go, Python, and NPM, enhancing software development with multi-language support and performance optimization.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Linear MCP Server
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
mermaid-mcp-server
A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.
Jira-Context-MCP
MCP server to provide Jira Tickets information to AI coding agents like Cursor

Linear MCP Server
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.

Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.