What is Vk Cloud Mcp Server

The vk-cloud-mcp-server is a Model Context Protocol (MCP) server for VK Cloud that allows management of cloud infrastructure using LLM through a standardized interface. It enables AI assistants and other tools to interact with VK Cloud resources.

Use cases

Use cases for vk-cloud-mcp-server include automating the deployment and management of virtual machines, managing network configurations, and handling storage resources in a cloud environment. It can also be used for experimental projects and research on MCP capabilities.

How to use

To use vk-cloud-mcp-server, first create a virtual environment and activate it. Then, install the required dependencies using pip. Finally, create a configuration file (‘config.yaml’) with your VK Cloud credentials to start managing your cloud resources.

Key features

Key features of vk-cloud-mcp-server include operations for virtual machines (VMs), network management, storage operations, and access management. Users can view, start, stop, and create VMs, manage networks and security groups, and handle storage volumes and SSH keys.

Where to use

vk-cloud-mcp-server can be used in cloud computing environments, particularly for managing virtual machines and other resources in VK Cloud. It is suitable for developers, system administrators, and researchers looking to automate cloud infrastructure management.

VK Cloud MCP Server

Сервер Model Context Protocol (MCP) для VK Cloud — это решение, которое предоставляет возможность управлять облачной инфраструктурой с помощью LLM через стандартизированный интерфейс.
Позволяет ИИ-ассистентам и другим инструментам взаимодействовать с ресурсами VK Cloud.

ВАЖНАЯ ИНФОРМАЦИЯ
НЕОФИЦИАЛЬНЫЙ ПРОЕКТ: Это неофициальная реализация сервера Model Context Protocol (MCP) для VK Cloud.
Данный проект не связан с VK Cloud, не поддерживается и не одобрен ими. Он был разработан независимо в качестве экспериментального проекта выходного дня для исследования возможностей MCP.
Вопросы, предложения и вклад в проект приветствуются. Пожалуйста, свяжитесь со мной через Telegram: @volinski.

Возможности

Данный MCP сервер предоставляет следующие операции для VK Cloud:

Операции с виртуальными машинами (VM)

• Просмотр списка всех VM в проекте
• Запуск остановленной VM
• Остановка работающей VM
• Перезапуск VM (мягкая или жесткая перезагрузка)
• Создание новой VM с различными опциями конфигурации
• Просмотр списка типов VM (flavors) с возможностью фильтрации
• Просмотр списка образов VM с расширенными возможностями фильтрации

Сетевые операции

• Просмотр списка всех сетей в проекте
• Просмотр списка всех групп безопасности в проекте

Операции с хранилищем

• Просмотр списка всех дисков (томов) с возможностью фильтрации
• Создание загрузочных томов из образов

Операции с доступом

• Просмотр списка всех SSH-ключей в проекте

Требования

• Python 3.8 или выше
• Активная учетная запись VK Cloud с доступом к API

Установка

Create virtual environment

python -m venv vk-cloud-mcp-venv

Activate the virtual environment

On Windows:
vk-cloud-mcp-venv\Scripts\activate

On macOS/Linux:
source vk-cloud-mcp-venv/bin/activate

Install dependencies

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. Пример файла для настройки MCP сервера для Windsurf 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

Это запустит MCP сервер по адресу http://localhost:8000/sse по умолчанию.

Соображения безопасности

• По умолчанию деструктивные операции (создание, запуск, остановка, перезапуск 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 (требуется включение деструктивных операций)

Для получения подробной информации о параметрах и использовании каждого инструмента см. документацию в коде.