К основному содержанию
MCP-сервер CX Codex

hypequery ClickHouse — MCP-сервер для Claude Code

MCP-сервер hypequery ClickHouse для Claude Code открывает агенту доступ к аналитике ClickHouse через размеченные датасеты и метрики. Прямой SQL блокируется, а реквизиты базы остаются скрытыми.

лицензия не указана ★ 106 обновлён 2026-11-16

Установить в Claude Code · Командой платформы Все способы и платформы ↓
claude mcp add mcp-server -- npx -y @hypequery/mcp
Открыть на GitHub

Что делает hypequery ClickHouse

Сервер даёт агентам четыре инструмента: list_datasets, get_dataset_schema, query_metric и query_dataset. Вместо прямого доступа к базе ассистент запрашивает заранее объявленные наборы данных и расчётные показатели семантического слоя.

Запуск возможен локально через скомпилированный конфиг Node.js либо через подключение к бекенду на Python по протоколу HTTP с помощью hypequery.serve. Во втором случае требуются переменные окружения HYPEQUERY_CLIENT_CONTRACT_URL и HYPEQUERY_API_KEY.

В режиме HTTP действуют строгие лимиты: таймаут 30 секунд, предел ответа 1 МиБ и не более 1000 строк на выборку. Физические ошибки базы и детали SQL-запросов скрываются за кодом MCP_EXECUTION_FAILED.

Какие задачи решает

  • запретить агенту выполнять произвольный SQL в ClickHouse
  • получать значения метрик и KPI по единым правилам
  • проверять схему и связи доступных датасетов
  • ограничивать объём выгружаемых строк и время ответа

Примеры запросов агенту

  • Покажи список доступных аналитических датасетов в ClickHouse
  • Рассчитай метрику revenue по регионам за прошлый месяц через query_metric
  • Выведи схему полей и связей для датасета Orders

Как установить hypequery ClickHouse

Командой платформы

claude mcp add mcp-server -- npx -y @hypequery/mcp

По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие

Вопросы о hypequery ClickHouse

Как установить hypequery ClickHouse в Claude Code?

Выполните команду claude mcp add mcp-server -- npx -y @hypequery/mcp.

Что делает hypequery ClickHouse?

Предоставляет агентам инструменты для чтения готовых наборов данных и метрик ClickHouse без прямого доступа к SQL и паролям базы.

Что нужно для работы hypequery ClickHouse?

Требуется скомпилированный конфигурационный файл на Node.js или запущенный Python-бекенд с заданными переменными HYPEQUERY_CLIENT_CONTRACT_URL и HYPEQUERY_API_KEY.

Похожие MCP-серверы

Все MCP-серверы по теме «Данные и базы» →
clickhouse-query civitai Скилл clickhouse-query гоняет ad-hoc запросы к ClickHouse прямо из чата с агентом: метрики, события, план выполнения. По умолчанию только чтение. CX Codex +1 ★ 7 327звёзд репо clickhouse-best-practices ClickHouse Inc Скилл clickhouse-best-practices для Claude Code проверяет схемы таблиц, SQL-запросы, полнотекстовый поиск и вставку данных в ClickHouse по набору из 36 правил. CX Codex +1 23 400установок ClickHouse ClickHouse MCP-сервер подключает Claude Code к кластерам ClickHouse и chDB: агент выполняет SQL и изучает базы и таблицы. CX Codex +1 ★ 913звёзд репо clickhouse-io affaan-m Скилл clickhouse-io для Claude Code помогает проектировать таблицы на движках MergeTree и ускорять медленные аналитические запросы. CX Codex +1 6 200установок clickhouse-architect terrylica Скилл clickhouse-architect проектирует схемы ClickHouse v24.4+, подбирает кодеки сжатия и настраивает ключи сортировки под облачные и серверные развёртывания. CX Codex +1 157установок clickhouse-cloud-management terrylica Скилл clickhouse-cloud-management помогает управлять пользователями и правами доступа в ClickHouse Cloud через SQL-запросы по HTTPS. CX Codex +1 126установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой