VK Cloud MCP Server

by stockblog

355 downloads

Not rated

GitHub

Other

Description

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

About

Details

Author: stockblog
Downloads: 355
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name VK Cloud MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

From the repository

Clone the repository, create a virtual environment, install dependencies from requirements.txt, and create a config.yaml with your VK Cloud API credentials. Set destructive_operations: true in the config to enable create/start/stop/restart actions. Run the server with python main.py; it listens on http://localhost:8000/sse by default.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "vk cloud mcp server": {
            "vk-cloud-mcp-server": {
                "command": "python",
                "args": [
                    "main.py"
                ]
            }
        }
    }
}

McpServers

{
    "vk-cloud-mcp-server": {
        "command": "python",
        "args": [
            "main.py"
        ]
    }
}

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 ``

yaml
   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

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



Запуск сервера


Запустите сервер командой:

bash
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 (требуется включение деструктивных операций) Для получения подробной информации о параметрах и использовании каждого инструмента см. документацию в коде.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

VK Cloud MCP Server

Возможности

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

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

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

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

Требования

Установка

Create virtual environment

Activate the virtual environment

Install dependencies

Запуск сервера

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

Доступные инструменты MCP

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀