MCP-сервер для Redis

MCP-сервер для Redis — это приложение, которое предоставляет AI-ассистентам доступ к базам данных Redis через стандартный протокол Model Context Protocol (MCP). Сервер разворачивается на виртуальной машине в Yandex Cloud и подключается к существующему кластеру Redis.

Основные возможности и преимущества

• Интеграция с Yandex AI Studio. MCP-сервер интегрируется с AI Studio MCP Серверы — подключите его к вашим AI-агентам в несколько кликов.
• Интеграция с AI-ассистентами. Позволяет AI-моделям выполнять операции с Redis: читать и записывать данные, управлять ключами, анализировать структуру базы данных.
• Авторизация Bearer-токеном. Все запросы к MCP-серверу защищены Bearer-токеном, который хранится в Yandex Lockbox.
• Безопасное подключение к Redis. Пароль для подключения к Redis хранится в Yandex Lockbox и извлекается при запуске. Поддержка TLS для шифрования соединения. Дополнительный CA-сертификат из Certificate Manager для подключений к Redis, которым он требуется.
• Стандартный протокол MCP. Использует открытый протокол Model Context Protocol для взаимодействия с AI-моделями, обеспечивая совместимость с широким спектром клиентов.
• HTTP-транспорт. MCP-сервер доступен на порту 8000 (HTTP), что упрощает интеграцию с различными клиентами и инструментами.
• Минимальные ресурсы. Приложение работает на виртуальной машине с минимальной конфигурацией (2 vCPU, 2 GB RAM), что снижает затраты на инфраструктуру.

1. Убедитесь, что у вас есть работающий кластер Redis: Yandex Managed Service for Valkey^™ или другой Redis.
2. Создайте секрет в Yandex Lockbox для хранения пароля Redis. Секрет должен содержать ключ redis_password со значением пароля.
3. Создайте секрет в Yandex Lockbox для хранения Bearer-токена авторизации. Секрет должен содержать ключ bearer_token с произвольным токеном.
4. (Опционально) Если для подключения к Redis требуется дополнительный CA-сертификат, загрузите сертификат в Yandex Certificate Manager.
5. Создайте сервисный аккаунт для установки приложения и назначьте ему на каталог установки роли compute.editor, iam.serviceAccounts.admin, vpc.admin, resource-manager.admin.
6. Назначьте установочному сервисному аккаунту роль lockbox.admin отдельно на секрет с Bearer-токеном и на секрет с паролем Redis. Роль нужна для чтения и изменения прав доступа к выбранным секретам; назначать её на каталог не требуется. Это правило действует и для секретов из другого каталога. При установке приложение создаст отдельный сервисный аккаунт ВМ и назначит ему lockbox.payloadViewer только на выбранные секреты.
7. Шаблон также назначает аккаунту ВМ certificate-manager.certificates.downloader на каталог установки. Для создания этой привязки IAM установочному аккаунту нужна роль resource-manager.admin, в том числе когда пользовательский сертификат не выбран. Если используете сертификат, выберите его из каталога установки; для сертификата из другого каталога отдельно предоставьте аккаунту ВМ доступ к нему.
8. В консоли управления выберите сервис Cloud Apps.
9. На панели слева выберите Магазин приложений.
10. Выберите MCP Redis и нажмите кнопку Использовать.
11. Укажите:
    • Имя приложения.
    • (Опционально) Описание приложения.
    • Сервисный аккаунт, созданный ранее.
    • Облачную подсеть, в которой будет развёрнута виртуальная машина.
    • Идентификатор секрета Lockbox с Bearer-токеном для авторизации.
    • TLS для подключения к Redis: отключён по умолчанию. Если Redis поддерживает TLS, выберите Включён и укажите его порт.
    • (Опционально) При включённом TLS выберите дополнительный CA-сертификат из Certificate Manager, если он требуется для подключения.
    • Хост Redis (FQDN).
    • Порт Redis. Если оставить поле пустым, приложение использует порт 6379. Режим TLS задаётся отдельно.
    • Имя пользователя Redis. Если оставить поле пустым, приложение использует имя пользователя default.
    • Идентификатор секрета Lockbox с паролем Redis.
    • Внешний доступ к MCP-серверу (опционально; по умолчанию выключен, включите для подключения по публичному IP-адресу).
    • Настройки SSH-доступа. Если выбрана ветка Включён, укажите имя пользователя и публичный SSH-ключ.
12. Нажмите кнопку Установить и дождитесь, пока приложение установится.
13. После установки выберите адрес подключения в разделе Данные приложения:
    • Для подключения из внешней сети используйте поле URL MCP-сервера: http://<public-ip>:8000/mcp. ВМ имеет публичный IP-адрес, а TCP-порт 8000 доступен из интернета только при включённом внешнем доступе, поэтому используйте Bearer-токен и передавайте адрес только доверенным клиентам.
    • Для подключения из внутренней сети используйте поле URL MCP-сервера (внутренний): http://<private-ip>:8000/mcp. Клиенту нужен сетевой доступ к внутреннему IP-адресу ВМ. Yandex AI Studio использует этот приватный адрес.
14. Настройте ваш AI-клиент для подключения к MCP-серверу, указав заголовок Authorization: Bearer <ваш-токен>.
15. Проверьте работу MCP-сервера: запросите список доступных инструментов, запишите через них временный ключ в Redis и прочитайте его. Убедитесь, что прочитанное значение совпадает с записанным, затем удалите тестовый ключ.

Подключение MCP-сервера к Yandex AI Studio

1. В консоли управления откройте сервис AI Studio и перейдите в раздел Agent Core → MCP-серверы.
2. Нажмите Создать MCP-сервер и в разделе MCP-серверы из Yandex Cloud Marketplace выберите нужный MCP-сервер.
3. Укажите имя сервера и выберите уже развёрнутый экземпляр приложения или создайте новый, следуя инструкциям по развёртыванию. При развёртывании нового сервера кнопка Сохранить будет доступна только после полного развёртывания и запуска MCP-сервера.
4. После выбора приложения значения параметров Сеть и Сервисный аккаунт MCP-сервера заполнятся автоматически.
5. Нажмите Создать. После успешной проверки подключения выберите необходимые инструменты (tools) и нажмите Сохранить — MCP-сервер будет зарегистрирован в AI Studio и доступен для использования AI-агентами.

• Управление ключами и значениями в Redis с помощью AI-ассистента.
• Анализ структуры данных и типов ключей в Redis через естественный язык.
• Мониторинг состояния сервера Redis и репликации с помощью AI.
• Автоматизация рутинных операций с Redis через AI-ассистента.
• Исследование и отладка данных, хранящихся в Redis.

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.