ClickHouse·ClickHouse

ClickHouse MCP — подключение и инструкция

Официальный ClickHouse MCP предоставляет агенту инструменты работы с базой ClickHouse и выполнения запросов через MCP.

Рабочие сервисыЛокальноAPI-ключ

Что умеет этот сервер

01

Официальный ClickHouse MCP предоставляет агенту инструменты работы с базой ClickHouse и выполнения запросов через MCP.

02

Сервер соединяется с конкретным экземпляром ClickHouse.

03

Получи список разрешённых баз и схему одной таблицы.

Задача для знакомства

Через 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.
  1. 01

    Подготовь окружение

    Доступный ClickHouse, учётная запись с нужными правами и Python/uv либо другой выбранный способ установки из README.

  2. 02

    Установи и настрой

    Выбери local или HTTP-вариант в README. Настрой адрес, порт, TLS и учётные данные ClickHouse в указанном env, затем добавь соответствующий MCP endpoint или launch command в клиент. Для первого теста используй отдельную учётную запись чтения.

  3. 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-серверов Нейролюба.

Вопросы о ClickHouse

Официальный ClickHouse MCP предоставляет агенту инструменты работы с базой ClickHouse и выполнения запросов через MCP.
Вернуться в библиотеку