ClickHouse·ClickHouse
ClickHouse MCP — подключение и инструкция
Официальный ClickHouse MCP предоставляет агенту инструменты работы с базой ClickHouse и выполнения запросов через MCP.
Что умеет этот сервер
Официальный ClickHouse MCP предоставляет агенту инструменты работы с базой ClickHouse и выполнения запросов через MCP.
Сервер соединяется с конкретным экземпляром ClickHouse.
Получи список разрешённых баз и схему одной таблицы.
Задача для знакомства
Через ClickHouse MCP покажи схему указанной таблицы и несколько строк с LIMIT. Запросы на изменение данных не выполняй.
Уточнить результат
Сверь database, table, timezone и число строк. При сетевой ошибке проверь отдельно доступность ClickHouse и MCP. При отказе запроса проверь SQL-права, а не расширяй их автоматически.
Как подключить
Выберите подходящий способПодключить ClickHouse MCP
Выбери local или HTTP-вариант в README. Настрой адрес, порт, TLS и учётные данные ClickHouse в указанном env, затем добавь соответствующий MCP endpoint или launch command в клиент. Для первого теста используй отдельную учётную запись чтения.
Что понадобится
- Доступный ClickHouse, учётная запись с нужными правами и Python/uv либо другой выбранный способ установки из README.
- 01
Подготовь окружение
Доступный ClickHouse, учётная запись с нужными правами и Python/uv либо другой выбранный способ установки из README.
- 02
Установи и настрой
Выбери local или HTTP-вариант в README. Настрой адрес, порт, TLS и учётные данные ClickHouse в указанном env, затем добавь соответствующий MCP endpoint или launch command в клиент. Для первого теста используй отдельную учётную запись чтения.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Первый запрос — пример для чата агента
Через ClickHouse MCP покажи схему указанной таблицы и несколько строк с LIMIT. Запросы на изменение данных не выполняй.Как проверить
Сверь database, table, timezone и число строк. При сетевой ошибке проверь отдельно доступность ClickHouse и MCP. При отказе запроса проверь SQL-права, а не расширяй их автоматически.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет ClickHouse
Официальный ClickHouse MCP предоставляет агенту инструменты работы с базой ClickHouse и выполнения запросов через MCP.
Сервер соединяется с конкретным экземпляром ClickHouse. README описывает несколько transports и варианты конфигурации; параметры HTTP самого MCP и подключения к ClickHouse — разные уровни.
Что подготовить перед подключением
Доступный ClickHouse, учётная запись с нужными правами и Python/uv либо другой выбранный способ установки из README.
Как установить и подключить
Выбери local или HTTP-вариант в README. Настрой адрес, порт, TLS и учётные данные ClickHouse в указанном env, затем добавь соответствующий MCP endpoint или launch command в клиент. Для первого теста используй отдельную учётную запись чтения.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Получи список разрешённых баз и схему одной таблицы. Выполни небольшой SELECT с явным LIMIT, укажи период и фильтр. Объясняй значения в контексте типов столбцов.
Как проверить результат и решить проблемы
Сверь database, table, timezone и число строк. При сетевой ошибке проверь отдельно доступность ClickHouse и MCP. При отказе запроса проверь SQL-права, а не расширяй их автоматически.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
SELECT может быть тяжёлым даже без записи. Доступ к базе и ограничения запросов определяются ClickHouse; не путай локальный MCP HTTP-порт с портом базы.
Исходники и документация
Репозиторий: ClickHouse/mcp-clickhouse. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.