ClickHouse MCP Server — это официальный MCP-сервер от команды ClickHouse, который предоставляет AI-ассистентам безопасный и управляемый доступ к аналитической СУБД ClickHouse. Он позволяет выполнять SQL-запросы и исследовать структуру данных, используя встроенные механизмы защиты и эмбеддированную версию движка chDB для работы без отдельного сервера.
Ключевые особенности:
Двухрежимная архитектура ClickHouse + chDB: Может работать как с полноценным кластером ClickHouse, так и со встроенным движком chDB, который позволяет выполнять аналитические запросы напрямую к файлам, URL-адресам и другим источникам данных без процессов ETL.
Многоуровневая система защиты данных: По умолчанию все запросы выполняются в режиме “только чтение”. Для операций записи (INSERT, UPDATE) требуется явно установить флаг CLICKHOUSE_ALLOW_WRITE_ACCESS=true, а для деструктивных действий (DROP, TRUNCATE) — дополнительный флаг CLICKHOUSE_ALLOW_DROP=true.
Гибкая аутентификация для удаленного доступа: Поддерживает три режима: статический Bearer-токен (для внутренних сервисов), делегирование провайдерам OAuth/OIDC (Azure Entra, Google, GitHub) через FastMCP и полное отключение для локальной разработки.
Интеллектуальный просмотр схемы: Инструмент list_tables поддерживает пагинацию с курсором, фильтрацию по шаблонам LIKE/NOT LIKE и опциональное отключение детальной колоночной метаинформации для облегченных ответов при исследовании больших инсталляций.
Расширяемая Middleware-система: Позволяет внедрять кастомную логику (логирование, замеры времени, динамическое переопределение конфигурации клиента на лету) без модификации исходного кода сервера.
Для кого: Ориентирован на дата-инженеров, аналитиков и разработчиков, использующих ClickHouse для высоконагруженной аналитики и желающих предоставить AI-ассистентам контролируемый доступ к данным для генерации и отладки запросов.
Сценарии использования:
Безопасное исследование production-данных: Предоставление AI-ассистенту доступа к кластеру ClickHouse в режиме “только чтение” для написания и валидации сложных аналитических SQL-запросов без риска изменения или удаления данных.
Ad-hoc анализ файлов без базы данных: Использование chDB для выполнения SQL-запросов напрямую к локальным CSV, Parquet или JSON-файлам через AI-интерфейс, минуя этап загрузки в СУБД.
Автоматизация Dev/Staging окружений: Безопасное включение операций записи на тестовых стендах для создания и наполнения таблиц с обязательным подтверждением деструктивных действий.
Интеграция с корпоративным SSO: Развертывание сервера как HTTP/SSE-эндпоинта с аутентификацией через Azure Entra или Google для безопасного доступа AI-агентов в корпоративной среде.
Отладка и мониторинг: Использование встроенного health-check эндпоинта /health для проверки соединения с ClickHouse в оркестраторах (Kubernetes) без раскрытия деталей конфигурации.
Цены и доступность: Сервер является официальным проектом с открытым исходным кодом (лицензия Apache 2.0) и полностью бесплатен. Устанавливается через uv или pip из PyPI. Для работы с ClickHouse Cloud требуется платная подписка на сервис, но можно использовать бесплатный SQL Playground или локальный Docker-инстанс.
