MCP-Server VBox

MCP-Server VBox

MCP server for enabling AI use local k8s resources

Wan-Hao

Developer Tools
Visit Server

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

安装和配置

  1. 安装依赖
npm install
  1. 构建项目
npm run build
  1. 配置 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 支持

Recommended Servers

playwright-mcp

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.

Official
Featured
TypeScript
Magic Component Platform (MCP)

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.

Official
Featured
Local
TypeScript
MCP Package Docs Server

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.

Featured
Local
TypeScript
Claude Code MCP

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.

Featured
Local
JavaScript
@kazuph/mcp-taskmanager

@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.

Featured
Local
JavaScript
Linear MCP Server

Linear MCP Server

Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.

Featured
JavaScript
mermaid-mcp-server

mermaid-mcp-server

A Model Context Protocol (MCP) server that converts Mermaid diagrams to PNG images.

Featured
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP server to provide Jira Tickets information to AI coding agents like Cursor

Featured
TypeScript
Linear MCP Server

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.

Featured
JavaScript
Sequential Thinking MCP Server

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.

Featured
Python