ClickHouse MCP: Документация
Обновлено:
Подключение
uv run --with mcp-clickhouse --python 3.13 mcp-clickhouse или pip install mcp-clickhouse (stdio, без авторизации). По HTTP/SSE — переменные CLICKHOUSE_HOST, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD (bearer) либо OAuth/OIDC. Для chDB отдельная авторизация не требуется — запросы идут к файлам и URL напрямую.
Инструменты
4 инструмента: run_query — выполнение SQL к подключённому кластеру ClickHouse; list_databases, list_tables — структура баз и таблиц; run_chdb_select_query — SQL-запросы через embedded chDB прямо к локальным файлам или URL (CSV, Parquet и др.) без ETL в кластер.
Сценарий для агента
«Сколько событий по источникам за сутки?», «проанализируй этот CSV по ссылке на аномалии», «покажи структуру таблиц в базе analytics», «сравни продажи за март и апрель одним запросом».
Тарифы
MCP-сервер бесплатный, open source (Apache-2.0). Сам ClickHouse — self-hosted бесплатно, ClickHouse Cloud — по тарифам вендора.