MCP сервер для ClickHouse

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

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

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

1. Убедитесь, что у вас есть работающий кластер ClickHouse (Managed Service for ClickHouse или self-hosted).
2. Создайте секрет в Yandex Lockbox для хранения пароля ClickHouse. Секрет должен содержать ключ clickhouse_password со значением пароля.
3. Создайте секрет в Yandex Lockbox для хранения Bearer-токена авторизации. Секрет должен содержать ключ bearer_token с произвольным токеном.
4. (Опционально) Если используется non-Managed ClickHouse^® и требуется дополнительный CA-сертификат, загрузите сертификат в Yandex Certificate Manager.
5. Создайте сервисный аккаунт с ролями compute.editor, iam.serviceAccounts.admin, lockbox.payloadViewer, vpc.admin (роль admin включает все указанные роли).
6. В консоли управления выберите сервис Cloud Apps.
7. На панели слева выберите Магазин приложений.
8. Выберите MCP ClickHouse и нажмите кнопку Использовать.
9. Укажите:
   • Имя приложения.
   • (Опционально) Описание приложения.
   • Сервисный аккаунт, созданный ранее.
   • Облачную подсеть, в которой будет развернута виртуальная машина.
   • Идентификатор секрета Lockbox с Bearer-токеном для авторизации.
   • (Опционально) Сертификат из Certificate Manager для подключения к ClickHouse^®.
   • Хост ClickHouse (FQDN).
   • Порт ClickHouse (по умолчанию 9440).
   • Имя пользователя ClickHouse (по умолчанию default).
   • Идентификатор секрета Lockbox с паролем ClickHouse.
10. Нажмите кнопку Установить и дождитесь, пока приложение установится.
11. После установки MCP сервер будет доступен по адресу http://<vm-ip>:8000.
12. Настройте ваш AI-клиент (Claude Desktop, Cursor и др.) для подключения к MCP серверу, указав заголовок Authorization: Bearer <ваш-токен>.

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

1. В консоли управления откройте сервис AI Studio и перейдите в раздел MCP Hub.
2. Нажмите Создать MCP-сервер и выберите тип Внешний MCP-сервер.
3. Укажите имя сервера и идентификатор сети VPC, в которой развёрнута виртуальная машина MCP-сервера. Идентификатор сети доступен на странице приложения в разделе Данные приложения, поле Идентификатор сети VPC.
4. На шаге подключения к MCP-серверу заполните параметры значениями из раздела Данные приложения:
   • Тип MCP-сервера — значение из поля Тип MCP-сервера.
   • URL MCP-сервера — значение из поля URL MCP-сервера (внутренний).
   • В блоке HTTP-заголовков добавьте заголовок Authorization со значением Bearer <bearer_token>, где <bearer_token> — токен из секрета Yandex Lockbox, указанного при установке приложения.
5. Нажмите Подключиться. После успешной проверки подключения выберите необходимые инструменты (tools) и нажмите Подключить — MCP-сервер будет зарегистрирован в AI Studio и доступен для использования AI-агентами.

• Анализ данных в ClickHouse с помощью AI-ассистента (Claude, ChatGPT).
• Автоматическая генерация SQL-запросов к ClickHouse через естественный язык.
• Исследование схемы базы данных ClickHouse с помощью AI.
• Мониторинг и анализ логов, хранящихся в ClickHouse.
• Построение отчётов и визуализаций на основе данных из ClickHouse.

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