Yandex Cloud MCP Server

🚀 НЕ официальный MCP сервер для управления ресурсами Yandex Cloud с поддержкой cloud/organization уровня.

Предоставляет функционал только для чтения (read-only API) следующих ресурсов Yandex Cloud: VMs, сети, диски, образы, зоны доступности, IP адреса и многое другое.

Возможности

📚 Полное покрытие API - все операции чтения Compute, VPC и Disks/Snapshots
🏗️ Многоуровневый доступ - folder/cloud/organization уровни
🧠 Умная навигация - автоматическое определение scope и подсказки
🔐 Гибкая аутентификация - через переменные окружения или интерактивно в Claude

Установка и настройка

Вариант 1: Запуск через uv (для разработки)

# Установка зависимостей
uv sync

# Настройка аутентификации
export YC_TOKEN="your_iam_token_here"
export YC_FOLDER_ID="your_folder_id_here"

# Запуск сервера
uv run mcp_server.py

Вариант 2: Запуск через Podman (для продакшена)

# Сборка образа
podman build -t yandex-cloud-mcp .

# Запуск контейнера
podman run -i --rm \
  -e YC_TOKEN="your_iam_token_here" \
  -e YC_FOLDER_ID="your_folder_id_here" \
  yandex-cloud-mcp

Подключение к Claude AI Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "yandex-cloud": {
      "command": "podman",
      "args": [
        "run", "-i", "--rm",
        "-e", "YC_TOKEN=your_token",
        "-e", "YC_FOLDER_ID=your_folder",
        "yandex-cloud-mcp"
      ]
    }
  }
}

Использование

# Настройка учетных данных (опционально - можно в переменных окружения)
Настрой учетные данные для Yandex Cloud: IAM токен t1.xxx... и folder ID b1gxxx...

# Основные операции
Покажи список всех виртуальных машин
Покажи все сети и подсети
Покажи контекст организации со всеми облаками
Посоветуй scope для запроса дисков

Получение учетных данных

IAM токен:

yc iam create-token

Folder ID:

yc config list

Тестирование

export YC_TOKEN="your_token"
export YC_FOLDER_ID="your_folder_id"
uv run test_server.py

Архитектура

src/yandex_cloud_mcp/
├── server.py          # Основной MCP сервер
├── credentials.py     # Управление учетными данными
├── compute.py         # ВМ, образы, зоны, типы дисков
├── network.py         # Сети, подсети, маршруты, IP, шлюзы
├── storage.py         # Диски и снапшоты
├── resource_manager.py # Cloud/Organization уровень
└── config.py          # Конфигурация

Полный перечень функций

🔐 Управление учетными данными

• setup_credentials(iam_token, folder_id) - настройка учетных данных
• get_credentials_status() - проверка статуса учетных данных
• clear_credentials() - очистка учетных данных

🏢 Cloud/Organization уровень

• list_yandex_clouds(organization_id) - список облаков в организации
• get_cloud_details_info(cloud_id) - детальная информация об облаке
• list_yandex_folders(cloud_id) - список папок (с автоопределением cloud_id)
• get_folder_details_info(folder_id) - детальная информация о папке
• get_yandex_organization_context() - полная иерархия организации
• suggest_query_scope(resource_type) - рекомендации по выбору scope

💻 Compute ресурсы

Виртуальные машины:

• list_virtual_machines(folder_id) - список ВМ
• get_virtual_machine_config(instance_id) - конфигурация ВМ

Образы и инфраструктура:

• list_compute_images(folder_id) - список образов
• get_image_configuration(image_id) - конфигурация образа
• list_availability_zones() - список зон доступности
• get_zone_configuration(zone_id) - конфигурация зоны
• list_compute_disk_types(zone_id) - типы дисков
• get_disk_type_configuration(disk_type_id) - конфигурация типа диска

🌐 VPC сетевые ресурсы

Основные сети:

• list_vpc_networks(folder_id) - список сетей
• get_network_configuration(network_id) - конфигурация сети
• list_vpc_subnets(folder_id) - список подсетей
• get_subnet_configuration(subnet_id) - конфигурация подсети

Безопасность и маршрутизация:

• list_vpc_security_groups(folder_id) - список групп безопасности
• get_security_group_details(security_group_id) - конфигурация группы с правилами
• list_vpc_route_tables(folder_id) - список таблиц маршрутизации
• get_route_table_configuration(route_table_id) - конфигурация таблицы маршрутов

IP адреса и шлюзы:

• list_vpc_addresses(folder_id) - список статических IP адресов
• get_address_configuration(address_id) - конфигурация IP адреса
• list_vpc_gateways(folder_id) - список шлюзов
• get_gateway_configuration(gateway_id) - конфигурация шлюза

💾 Storage ресурсы

• list_storage_disks(folder_id) - список дисков
• get_disk_details(disk_id) - конфигурация диска
• list_disk_snapshots(folder_id) - список снапшотов
• get_snapshot_details(snapshot_id) - конфигурация снапшота