Repolode
Предложить
ClickHouse

ClickHouse/mcp-clickhouse

MCP-сервер для SQL-запросов и изучения схем ClickHouse через AI-ассистентов; по умолчанию работает только на чтение.

Открыть на GitHub
Звёзды
890
Форки
210
Открытые issues
8
Последний коммит
вчера

Что это?

mcp-clickhouse — это сервер Model Context Protocol (MCP), который подключает AI-ассистентов, например Claude Desktop, к базе данных ClickHouse. Он предоставляет инструменты для просмотра списка баз данных, постраничного просмотра таблиц и выполнения SQL-запросов, позволяя ассистенту изучать схему и отвечать на аналитические вопросы по актуальным данным.

По умолчанию запросы выполняются только на чтение. Запись нужно явно разрешить через CLICKHOUSE_ALLOW_WRITE_ACCESS, а для деструктивных операторов, таких как DROP, TRUNCATE, DELETE и UPDATE, требуется отдельно включить дополнительный флаг. В проект также входит необязательный бэкенд chDB для запросов к локальным файлам и источникам через встроенный движок ClickHouse. Поддерживаются транспорты stdio и HTTP/SSE с аутентификацией по bearer-токену или через OAuth/OIDC.

Сервер написан на Python и устанавливается из PyPI; обычно его запускают с помощью uv. Для HTTP-развёртываний также предусмотрен эндпоинт /health.

Ключевые возможности

  • 01Выполнять SQL-запросы к кластеру ClickHouse и получать результаты в формате JSON.
  • 02Просматривать список баз данных и таблицы постранично, используя фильтры LIKE.
  • 03По умолчанию работать только на чтение; запись и деструктивные операции разрешаются отдельными флагами.
  • 04Выполнять параметризованные запросы с плейсхолдерами ClickHouse {name:Type}.
  • 05Использовать необязательный бэкенд chDB для запросов к файлам и источникам без ETL.
  • 06Поддерживать транспорты stdio, HTTP и SSE с аутентификацией по bearer-токену или через OAuth/OIDC.

Сценарии использования

  • Дать AI-ассистенту возможность изучать схемы таблиц и отвечать на вопросы по данным ClickHouse.
  • Предоставить аналитикам диалоговый интерфейс для работы с аналитическими данными в режиме только для чтения.
  • Запрашивать локальные файлы или удалённые источники через встроенный движок chDB из ассистента.

Быстрый старт

  1. 1

    Установите пакет из PyPI с дополнительным extra chDB

    pip install 'mcp-clickhouse[chdb]'
  2. 2

    Настройте подключение к ClickHouse и запустите сервер, как описано в README

Что важно знать

  • Для успешного запуска необходимо заранее настроить аутентификацию для транспортов HTTP и SSE.

В подборках

Open source фреймворки и приложения для ИИ-агентовMCP-серверыБазы данных и инструменты SQL

Темы

#mcp#clickhouse#sql#ai-agent#database#llm-tools#python

Частые вопросы

Что такое mcp-clickhouse?
MCP-сервер для SQL-запросов и изучения схем ClickHouse через AI-ассистентов; по умолчанию работает только на чтение. mcp-clickhouse — это сервер Model Context Protocol (MCP), который подключает AI-ассистентов, например Claude Desktop, к базе данных ClickHouse. Он предоставляет инструменты для просмотра списка баз данных, постраничного просмотра таблиц и выполнения SQL-запросов, позволяя ассистенту изучать схему и отвечать на аналитические вопросы по актуальным данным.
mcp-clickhouse можно использовать бесплатно? Какая у него лицензия?
mcp-clickhouse распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
mcp-clickhouse всё ещё поддерживается?
Активно поддерживается. Последний коммит в mcp-clickhouse — 21 окт. 2026 г..
Для чего можно использовать mcp-clickhouse?
Дать AI-ассистенту возможность изучать схемы таблиц и отвечать на вопросы по данным ClickHouse. Предоставить аналитикам диалоговый интерфейс для работы с аналитическими данными в режиме только для чтения. Запрашивать локальные файлы или удалённые источники через встроенный движок chDB из ассистента.
Как установить mcp-clickhouse?
Установите пакет из PyPI с дополнительным extra chDB: pip install 'mcp-clickhouse[chdb]' Настройте подключение к ClickHouse и запустите сервер, как описано в README
Где скачать mcp-clickhouse?
Исходный код и инструкции по установке — на GitHub: https://github.com/ClickHouse/mcp-clickhouse

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты