VK Cloud MCP Server

VK Cloud MCP サーバー

VK Cloud 用の Model Context Protocol（MCP）サーバーは、標準化されたインターフェースを通じて LLM を使用し、クラウドインフラストラクチャを管理できるソリューションです。 AI アシスタントやその他のツールが VK Cloud のリソースとやり取りできるようにします。

重要なお知らせ
非公式プロジェクト：これは VK Cloud 用の Model Context Protocol（MCP）サーバーの非公式な実装です。
このプロジェクトは VK Cloud とは関係がなく、同社によるサポートや承認を受けていません。MCP の可能性を調査するための週末の実験プロジェクトとして、独自に開発されました。
ご質問、ご提案、プロジェクトへの貢献を歓迎します。Telegram：@volinski からご連絡ください。

機能

この MCP サーバーは、VK Cloud 向けに以下の操作を提供します。

仮想マシン（VM）の操作

• プロジェクト内のすべての VM の一覧を表示
• 停止中の VM を起動
• 実行中の VM を停止
• VM を再起動（ソフトまたはハードリブート）
• さまざまな設定オプションを指定して新しい VM を作成
• VM タイプ（フレーバー）の一覧をフィルタリングして表示
• 高度なフィルタリング機能を使用して VM イメージの一覧を表示

ネットワーク操作

• プロジェクト内のすべてのネットワークの一覧を表示
• プロジェクト内のすべてのセキュリティグループの一覧を表示

ストレージ操作

• すべてのディスク（ボリューム）の一覧をフィルタリングして表示
• イメージからブートボリュームを作成

アクセス操作

• プロジェクト内のすべての SSH キーの一覧を表示

要件

• Python 3.8 以降
• API にアクセスできる有効な VK Cloud アカウント

インストール

仮想環境を作成

python -m venv vk-cloud-mcp-venv

仮想環境を有効化

Windows の場合：
vk-cloud-mcp-venv\Scripts\activate

macOS/Linux の場合：
source vk-cloud-mcp-venv/bin/activate

依存関係をインストール

pip install -r requirements.txt

1. VK Cloud の認証情報を入力した設定ファイル（config.yaml）を作成します。
   入力する情報はすべて「プロジェクト設定」→「API アクセス」セクションで確認できます。
   https://cloud.vk.com/docs/ru/tools-for-using-services/api/rest-api/enable-api

   vkcloud:
     auth_url: "https://infra.mail.ru:35357/v3/"
     username: "your-username"
     password: "your-password"
     project_id: "your-project-id"
     user_domain_name: "users"
     project_domain_name: "Default"
     destructive_operations: false  # Установите true для разрешения создания/запуска/остановки VM  
     compute_endpoint: "https://infra.mail.ru:8774/v2.1"
     image_endpoint: "https://infra.mail.ru:9292/v2"
     block_storage_endpoint: "https://public.infra.mail.ru:8776/v3"
   

2. Windsurf 用 MCP サーバー設定ファイル mcp_config.json の例 https://docs.windsurf.com/windsurf/mcp#adding-a-new-server https://docs.windsurf.com/windsurf/mcp#mcp-config-json

   {
     "mcpServers": {
       "vkcloud": {
         "serverUrl": "http://localhost:8000/sse"
       }
     }
   }
   

サーバーの起動

次のコマンドでサーバーを起動します。

python main.py

これにより、デフォルトで http://localhost:8000/sse に MCP サーバーが起動します。

セキュリティに関する考慮事項

• デフォルトでは、破壊的な操作（VM の作成、起動、停止、再起動）は無効になっています。設定ファイルで destructive_operations: true を設定してください。

利用可能な MCP ツール

サーバーは以下の MCP ツールを提供します。

• vkcloud_vm_list：プロジェクト内のすべての VM の一覧
• vkcloud_network_list：すべてのネットワークの一覧
• vkcloud_security_group_list：すべてのセキュリティグループの一覧
• vkcloud_vm_start：VM を起動（破壊的な操作の有効化が必要）
• vkcloud_vm_stop：VM を停止（破壊的な操作の有効化が必要）
• vkcloud_vm_restart：VM を再起動（破壊的な操作の有効化が必要）
• vkcloud_flavor_list：フィルタリング機能付きの VM タイプ一覧
• vkcloud_image_list：高度なフィルタリング機能付きの VM イメージ一覧
• vkcloud_disk_list：フィルタリング機能付きのすべてのディスク（ボリューム）の一覧
• vkcloud_keypair_list：すべての SSH キーの一覧
• vkcloud_create_bootable_volume：ブートボリュームを作成（破壊的な操作の有効化が必要）
• vkcloud_vm_create：新しい VM を作成（破壊的な操作の有効化が必要）

各ツールのパラメーターと使用方法の詳細については、コード内のドキュメントを参照してください。