MCP-Server VBox

What is MCP-Server VBox?

MCP-Server VBox is a Model Context Protocol (MCP) server implementation for managing Docker containers and Kubernetes clusters. It provides a unified interface that lets users perform container and pod operations through Claude Desktop.

How to use MCP-Server VBox?

Install dependencies with npm install, build the project with npm run build, then configure Claude Desktop by adding the server entry to claude_desktop_config.json with the node command pointing to the built build/index.js. Ensure the Docker daemon is running and a valid Kubernetes configuration is available at ~/.kube/config.

Key features of MCP-Server VBox

• List Docker containers, pull images, and create containers.
• List Kubernetes pods, create deployments, and execute commands in pods.
• Enter an interactive shell in a pod and exit the pod execution environment.
• Get the current execution context (local or pod).
• Execute commands in the current environment with real-time output.
• Debug mode with inspection support via --inspect.

Use cases of MCP-Server VBox

• Manage Docker containers and Kubernetes clusters using natural language in Claude Desktop.
• Deploy Kubernetes pods and deployments without leaving the chat interface.
• Execute interactive shell commands inside containers or pods remotely.
• Simplify daily operations by unifying Docker and Kubernetes management in one tool.

FAQ from MCP-Server VBox

What are the system requirements for MCP-Server VBox?

Node.js >= 14.0.0, Docker, a Kubernetes cluster with configuration at ~/.kube/config, and Claude Desktop.

How do I configure MCP-Server VBox in Claude Desktop?

Add the server to ~/Library/Application Support/Claude/claude_desktop_config.json with command set to node and args containing the full path to build/index.js.

Where can I find the logs for debugging?

MCP server logs are at ~/Library/Logs/Claude/mcp-server-vbox.log; Claude Desktop logs are at ~/Library/Logs/Claude/mcp.log. Enable debug mode by adding "debug": true in the config.

What should I check before using the server?

Ensure the Docker daemon is running, the Kubernetes config file is correct, you have sufficient cluster permissions, and the correct namespace and pod name are specified when using pod features.

What Docker and Kubernetes operations are included?

Docker: docker_list_containers, docker_pull_image, docker_create_container. Kubernetes: k8s_list_pods, k8s_create_deployment, k8s_exec_pod, k8s_enter_pod, k8s_exit_pod. Also get_execution_context and execute_command.