VK Cloud MCP Server

VK Cloud MCP 服务

VK Cloud 的 Model Context Protocol（MCP）服务是一种解决方案，可通过标准化接口使用大模型管理云基础设施。 它允许 AI 助手和其他工具与 VK Cloud 资源交互。

重要信息
非官方项目：这是 VK Cloud 的 Model Context Protocol（MCP）服务的非官方实现。
本项目与 VK Cloud 无关，未获得其支持或认可。本项目由独立开发者开发，是一个用于探索 MCP 功能的周末实验项目。
欢迎提出问题、建议和贡献。请通过 Telegram 联系我：@volinski。

功能

此 MCP 服务为 VK Cloud 提供以下操作：

虚拟机（VM）操作

• 查看项目中的所有 VM
• 启动已停止的 VM
• 停止正在运行的 VM
• 重启 VM（软重启或硬重启）
• 创建具有各种配置选项的新 VM
• 查看 VM 类型（flavor）列表，并支持筛选
• 查看 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. 创建配置文件（config.yaml），填写你的 VK Cloud 凭据。
   所有需要填写的信息都可以在“项目设置” -> “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（需要启用破坏性操作）

有关每个工具的参数和用法的详细信息，请参阅代码中的文档。