clickhouse — плагин для Claude Code: скиллы и MCP-сервер ClickHouse
Подключает Claude к базам ClickHouse Cloud: просмотр схем, read-only SQL-запросы и правила по работе с ClickHouse.
/plugin install clickhouse@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialЧто делает clickhouse
Официальный плагин ClickHouse для Claude. Внутри два компонента: набор скиллов с правилами по проектированию схем, оптимизации запросов и загрузке данных, а также MCP-сервер, который связывает Claude с ClickHouse Cloud Remote MCP.
Через MCP-сервер агент видит организации, сервисы, базы и схемы таблиц, выполняет read-only SQL-запросы, показывает состояние бэкапов, расходы по биллингу и конфигурации ClickPipe. Скиллы подключаются сами, когда вы работаете с ClickHouse, — отдельно их вызывать не нужно.
Правила берутся из репозитория ClickHouse/agent-skills и синхронизируются еженедельным GitHub Action, который пушит изменения прямо в main; источник подключён как git submodule в submodules/agent-skills. Запросы только на чтение, так что менять данные через плагин не выйдет. Лицензия — Apache 2.0.
Какие задачи решает
- посмотреть схему таблиц в ClickHouse Cloud, не открывая консоль
- выполнить read-only SQL-запрос и сразу получить аналитический ответ
- проверить, когда последний раз делался бэкап сервиса
- разобраться с расходами по биллингу ClickHouse
- посмотреть конфигурацию ClickPipe
Примеры запросов агенту
- Покажи список сервисов в моей организации ClickHouse
- Выполни read-only запрос: сколько строк в таблице events за последние сутки
- Проверь бэкапы сервиса и покажи расходы за месяц
Как установить clickhouse
Через маркетплейс плагинов
/plugin install clickhouse@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о clickhouse
Как установить clickhouse в Claude Code?
Сначала добавьте маркетплейс: /plugin marketplace add anthropics/claude-plugins-official, затем установите плагин: /plugin install clickhouse@claude-plugins-official.
Что делает плагин clickhouse?
Добавляет в Claude скиллы с правилами по ClickHouse и MCP-сервер для работы с ClickHouse Cloud: просмотр схем, read-only SQL-запросы, бэкапы, биллинг и ClickPipe.
Можно ли через плагин менять данные в ClickHouse?
Нет. MCP-сервер выполняет только read-only SQL-запросы, запись и изменение данных через него недоступны.
Исходный текст
SKILL.md · Apache-2.0
# ClickHouse Claude Code Plugin The official Claude Code Plugin for [ClickHouse](https://clickhouse.com/). Extends Claude Code with ClickHouse best practice skills, rules, and the ClickHouse MCP server. ## Installation Install from the Claude Code plugin directory (pending marketplace approval): ```bash claude plugin install clickhouse@claude-plugins-official ``` Or clone the repo and load it directly: ```bash git clone --recursive https://github.com/ClickHouse/clickhouse-claude-code-plugin claude --plugin-dir ./clickhouse-claude-code-plugin ``` ## What's included - **Skills** — ClickHouse best practice rules covering schema design, query optimization, and data ingestion, applied automatically when you work with ClickHouse - **MCP Server** — connects Claude Code to the [ClickHouse Cloud Remote MCP server](https://clickhouse.com/docs/cloud/features/ai-ml/remote-mcp) for schema inspection and read-only SQL queries against your clusters See [`skills/clickhouse-best-practices/`](./skills/clickhouse-best-practices/) for the full rule set. ## Keeping skills up to date Best practice rules are sourced from [ClickHouse/agent-skills](https://github.com/ClickHouse/agent-skills) and kept in sync via a weekly GitHub Action that pushes upstream changes directly to `main`. The source is tracked as a git submodule at `submodules/agent-skills`. ## License Apache 2.0 — see [LICENSE](./LICENSE) for details.
© ClickHouse · Apache-2.0 · ClickHouse/clickhouse-claude-code-plugin
