MCP Server Vbox

🚀 MCP-Server VBox

MCP-Server VBox is a server implementation based on the Model Context Protocol (MCP) for managing and operating Docker containers and Kubernetes clusters. It provides a unified interface that allows you to conveniently perform container and Pod-related operations through Claude Desktop.

🚀 Quick Start

MCP-Server VBox simplifies the management of Docker containers and Kubernetes clusters. With a unified interface, you can easily perform various operations via Claude Desktop.

✨ Features

Docker Operations

• List all containers (docker_list_containers)
• Pull Docker images (docker_pull_image)
• Create new containers (docker_create_container)

Kubernetes Operations

• List Pods in a specified namespace (k8s_list_pods)
• Create a Deployment (k8s_create_deployment)
• Execute commands in a Pod (k8s_exec_pod)
• Enter the interactive shell of a Pod (k8s_enter_pod)
• Exit the execution environment of a Pod (k8s_exit_pod)

Execution Environment Management

• Get the current execution environment (get_execution_context)
• Execute commands in the current environment (execute_command)
• Support both local and Pod execution environments
• Real-time command execution and output

📦 Installation

System Requirements

• Node.js >= 14.0.0
• Docker
• Kubernetes cluster configuration (~/.kube/config)
• Claude Desktop

Installation Steps

1. Install dependencies

npm install

2. Build the project

npm run build

3. Configure Claude Desktop

Add the following configuration to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Note: Replace /path/to/your/vbox with the actual project path.

💻 Usage Examples

Basic Usage

To start using MCP-Server VBox, first ensure all dependencies are installed and the project is built. Then, configure Claude Desktop as described above.

Advanced Usage

If you need to debug, add debugging options to the Claude Desktop configuration:

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

Log File Locations

• MCP server logs: ~/Library/Logs/Claude/mcp-server-vbox.log
• Claude Desktop logs: ~/Library/Logs/Claude/mcp.log

📄 License

This project is licensed under the MIT License.

👨‍💻 Author

[Your Name]

📝 Changelog

1.0.0

• Initial release
• Implemented basic Docker and Kubernetes operation functions
• Added support for interactive shell

⚠️ Important Note

• Ensure that the Docker daemon is running.
• Ensure that you have the correct Kubernetes configuration file (default location: ~/.kube/config).
• Ensure that you have appropriate cluster access permissions.
• When using Pod-related functions, ensure that you specify the correct namespace and Pod name.