MCP Server Vbox

🚀 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 の対話型シェルに入る（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

2. プロジェクトのビルド

npm run build

3. 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 操作機能の実装
• 対話型シェルのサポートの追加