ClickHouse — MCP-сервер для Claude Code: запросы и установка
MCP-сервер подключает Claude Code к кластерам ClickHouse и chDB: агент выполняет SQL и изучает базы и таблицы.
claude mcp add --env CLICKHOUSE_HOST=<CLICKHOUSE_HOST> --env CLICKHOUSE_USER=<CLICKHOUSE_USER> --env CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD> --env CLICKHOUSE_PORT=<CLICKHOUSE_PORT> --env CLICKHOUSE_SECURE=<CLICKHOUSE_SECURE> --transport stdio clickhouse -- uvx mcp-clickhouseЧто делает ClickHouse
ClickHouse даёт агенту инструменты для работы с данными: выполнение SQL через run_query, список баз через list_databases и просмотр таблиц через list_tables. Для таблиц доступны фильтры по имени, постраничная выдача и подробные сведения о колонках. Запросы по умолчанию выполняются в режиме только чтения.
Параметры можно передавать отдельно от SQL через params и плейсхолдеры вида {name:Type}. Через run_query также доступны DESCRIBE для проверки схемы результата и EXPLAIN ESTIMATE для оценки чтения. Без CLICKHOUSE_HOST, CLICKHOUSE_USER и CLICKHOUSE_PASSWORD подключение не настроить; порт и защищённое соединение задаются отдельными переменными.
Какие задачи решает
- выполнять SQL-запросы в кластере ClickHouse
- просматривать базы и таблицы ClickHouse
- передавать значения в параметризованные запросы
- проверять схему результата до выполнения запроса
- оценивать объём чтения перед SELECT
Примеры запросов агенту
- Выполни запрос к ClickHouse: посчитай продажи по дням из таблицы
events. - Покажи базы и таблицы в ClickHouse, затем найди таблицы с именем
orders. - Проверь через
DESCRIBE, какие колонки вернёт этот SQL, и оцени чтение черезEXPLAIN ESTIMATE.
Как установить ClickHouse
Командой платформы
claude mcp add --env CLICKHOUSE_HOST=<CLICKHOUSE_HOST> --env CLICKHOUSE_USER=<CLICKHOUSE_USER> --env CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD> --env CLICKHOUSE_PORT=<CLICKHOUSE_PORT> --env CLICKHOUSE_SECURE=<CLICKHOUSE_SECURE> --transport stdio clickhouse -- uvx mcp-clickhouseВместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-clickhouse <команда>
Командой платформы
codex mcp add clickhouse --env CLICKHOUSE_HOST=<CLICKHOUSE_HOST> --env CLICKHOUSE_USER=<CLICKHOUSE_USER> --env CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD> --env CLICKHOUSE_PORT=<CLICKHOUSE_PORT> --env CLICKHOUSE_SECURE=<CLICKHOUSE_SECURE> -- uvx mcp-clickhouseВместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-clickhouse <команда>
Файл настроек
{
"mcpServers": {
"clickhouse": {
"command": "uvx",
"args": [
"mcp-clickhouse"
],
"env": {
"CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>",
"CLICKHOUSE_USER": "<CLICKHOUSE_USER>",
"CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>",
"CLICKHOUSE_PORT": "<CLICKHOUSE_PORT>",
"CLICKHOUSE_SECURE": "<CLICKHOUSE_SECURE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-clickhouse <команда>
Файл настроек
{
"servers": {
"clickhouse": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-clickhouse"
],
"env": {
"CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>",
"CLICKHOUSE_USER": "<CLICKHOUSE_USER>",
"CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>",
"CLICKHOUSE_PORT": "<CLICKHOUSE_PORT>",
"CLICKHOUSE_SECURE": "<CLICKHOUSE_SECURE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-clickhouse <команда>
Командой платформы
gemini mcp add -e CLICKHOUSE_HOST=<CLICKHOUSE_HOST> -e CLICKHOUSE_USER=<CLICKHOUSE_USER> -e CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD> -e CLICKHOUSE_PORT=<CLICKHOUSE_PORT> -e CLICKHOUSE_SECURE=<CLICKHOUSE_SECURE> clickhouse uvx mcp-clickhouseВместо <…> подставьте свои значения. Ещё 11 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-clickhouse <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «Данные и базы»
Все MCP-серверы по теме «Данные и базы» →Вопросы о ClickHouse
Как установить ClickHouse в Claude Code?
Выполните `claude mcp add mcp-clickhouse -e CLICKHOUSE_HOST=<CLICKHOUSE_HOST> -e CLICKHOUSE_USER=<CLICKHOUSE_USER> -e CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD> -- uvx mcp-clickhouse`.
Что делает ClickHouse MCP-сервер?
Он позволяет агенту выполнять SQL в ClickHouse, получать список баз и просматривать таблицы. Сервер также поддерживает DESCRIBE и EXPLAIN ESTIMATE через инструмент run_query.
Как передавать параметры в SQL-запросе?
Значения передаются в объекте params, а в SQL используются плейсхолдеры ClickHouse вида {name:Type}. Форматы %s, %(name)s и $name$ для этого сервера не поддерживаются.
