hypequery ClickHouse — MCP-сервер для Claude Code
MCP-сервер hypequery ClickHouse для Claude Code открывает агенту доступ к аналитике ClickHouse через размеченные датасеты и метрики. Прямой SQL блокируется, а реквизиты базы остаются скрытыми.
лицензия не указана ★ 106 обновлён 2026-11-16
claude mcp add mcp-server -- npx -y @hypequery/mcpЧто делает 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Командой платформы
codex mcp add mcp-server -- npx -y @hypequery/mcpФайл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@hypequery/mcp"
]
}
}
}Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hypequery/mcp"
]
}
}
}Командой платформы
gemini 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.