Каталог MCP
ClickHouse/mcp-clickhouse

ClickHouse/mcp-clickhouse

MCP сервер для работы с ClickHouse: выполняет SQL-запросы, перечисляет базы и таблицы с пагинацией. Поддерживает chDB для быстрых встраиваемых запросов без ETL. Полезен разработчикам и аналитикам для интеграции ClickHouse в AI-инструменты через MCP.

README

3 инструмента

Версии

Установить сервер

ClickHouse MCP Server

An MCP server for ClickHouse.

Features

ClickHouse Tools

run_query
- Execute SQL queries on your ClickHouse cluster.
- Input: query (string): The SQL query to execute.
- Queries run in read-only mode by default (CLICKHOUSE_ALLOW_WRITE_ACCESS=false), but writes can be enabled explicitly if needed.
list_databases
- List all databases on your ClickHouse cluster.
list_tables
- List tables in a database with pagination.
- Required input: database (string).
- Optional inputs:
  - like / not_like (string): Apply LIKE or NOT LIKE filters to table names.
  - page_token (string): Token returned by a previous call for fetching the next page.
  - page_size (int, default 50): Number of tables returned per page.
  - include_detailed_columns (bool, default true): When false, omits column metadata for lighter responses while keeping the full create_table_query.
- Response shape:
  - tables: Array of table objects for the current page.
  - next_page_token: Pass this value back to fetch the next page, or null when there are no more tables.
  - total_tables: Total count of tables that match the supplied filters.

Инструменты были проиндексированы: 11.09.2026

list_databases

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

List Databases

Параметры

Без параметров.

list_tables

List available ClickHouse tables in a database, including schema, comment, row count, and column count. Integers outside [-9007199254740991, 9007199254740991] in table metadata are returned as decimal strings. Pagination tokens are single-use and retained for up to one hour.

List Tables

Параметры

databasestringобязательный
The database to list tables from
include_detailed_columnsboolean
Whether to include detailed column metadata (default: True). When False, the columns array will be empty but create_table_query still contains all column information. This reduces payload size for large schemas.
likestring | null
Optional LIKE pattern to filter table names
not_likestring | null
Optional NOT LIKE pattern to exclude table names
page_sizeinteger
Number of tables to return per page (default: 50, must be greater than 0)
page_tokenstring | null
Single-use token from a previous call, retained for up to one hour

run_query

Выполняет SQL-запросы в ClickHouse. По умолчанию запросы работают в режиме только для чтения. Установите CLICKHOUSE_ALLOW_WRITE_ACCESS=true, чтобы разрешить операции DDL и DML. Установите CLICKHOUSE_ALLOW_DROP=true, чтобы дополнительно разрешить разрушительные операции (DROP, TRUNCATE, DELETE, UPDATE, REPLACE TABLE/PARTITION, CREATE OR REPLACE, CLEAR COLUMN/INDEX/PROJECTION, DETACH PERMANENTLY). Эта защита - мера предосторожности от случайных ошибок, а не граница безопасности. Целые числа вне диапазона [-9007199254740991, 9007199254740991] возвращаются в виде десятичных строк.

Run Query

Параметры

querystringобязательный

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp-clickhouse",
    "--python",
    "3.10",
    "mcp-clickhouse"
  ],
  "env": {
    "CLICKHOUSE_HOST": "<clickhouse-host>",
    "CLICKHOUSE_PORT": "<clickhouse-port>",
    "CLICKHOUSE_USER": "<clickhouse-user>",
    "CLICKHOUSE_PASSWORD": "<clickhouse-password>",
    "CLICKHOUSE_ROLE": "<clickhouse-role>",
    "CLICKHOUSE_SECURE": "true",
    "CLICKHOUSE_VERIFY": "true",
    "CLICKHOUSE_CONNECT_TIMEOUT": "30",
    "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
  }
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

FAQ

Для чего этот сервер?

Этот сервер соединяет ClickHouse с AI-агентами и ассистентами: через модель можно выполнять SQL-запросы, смотреть список баз и таблиц. Вместо того чтобы вручную подключаться к базе, разработчик получает прямой доступ к данным через чат-интерфейс. Сервер берет на себя аутентификацию и безопасность, позволяя работать с ClickHouse прямо из диалога с ИИ. Удобно для быстрой аналитики и прототипирования без лишних инструментов.

Что он умеет?

Сервер выполняет SQL-запросы к ClickHouse: читает данные, а при включённой настройке `CLICKHOUSE_ALLOW_WRITE_ACCESS=true` — изменяет их. Перечисляет базы данных и таблицы, показывает схему, комментарии, число строк и столбцов. Работает через MCP, поддерживает HTTP/SSE и stdio, требует авторизации (токен или OAuth) для сетевых транспортов.

Информация о сервере

Номер в рейтинге: #107
Звезд на Github: 869
Форков на Github: 206
Загрузок: 1 058 187
Язык реализации: Python
Лицензия: Apache-2.0
Официальный сервер: Да
Дата обновления данных: 10.09 в 23:49
Идентификатор: qorjgdanev2mZR_f
Категории: Базы данных, Инструменты для разработчиков

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

jparkerweb/mcp-sqlite

MCP сервер для работы с SQLite: выполняет CRUD-операции, исследование схемы таблиц и произвольные SQL-запросы. Полезен разработчикам, управляющим базами данных через ИИ-ассистентов.

f4ww4z/mcp-mysql-server

MCP сервер для MySQL: управляет подключениями, выполняет SQL-запросы и описывает таблицы. Поддерживает безопасные параметризованные запросы (prepared statements). Идеален для ИИ-агентов, которым ну...

ofershap/mcp-server-sqlite

MCP сервер для безопасного выполнения SQL-запросов к SQLite через AI ассистента. Инспектирует схемы, таблицы, объясняет запросы. Безопасный режим только чтения, совместим с Cursor, Claude Desktop и...

ktanaka101/mcp-server-duckdb

MCP сервер для DuckDB позволяет LLM выполнять SQL-запросы, создавать таблицы и просматривать схему. Для локального анализа: откройте .db-файл в режиме read-only или с постоянным подключением. Устан...

designcomputer/mysql_mcp_server

MCP инструмент для безопасной работы AI-агентов с MySQL. Выполняет SQL-запросы, возвращает схему таблиц и выборки данных. Помогает разработчикам и аналитикам контролировать доступ, избегая SQL-инъекций и используя SSL/TLS.

quantgeekdev/mongo-mcp

MCP сервер для MongoDB: LLM выполняет запросы, инспектирует схемы и управляет документами с индексами на естественном языке. Полезен разработчикам для автоматизации работы с базами данных.