ycmcp

romati88/ycmcp

3.1

If you are the rightful owner of ycmcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Yandex Cloud MCP Server is an unofficial read-only API server for managing Yandex Cloud resources at the cloud/organization level.

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) - конфигурация снапшота