MMCPMarkets
CM

clickhouse/mcp-clickhouse

Developer toolsОфициальный

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

898 stars 210 forks Качество 87 Тренд 44Apache-2.0
Repository Install

Подключите ClickHouse к вашим AI-ассистентам.

Обзор

* run_query * Выполнить SQL-запросы на вашем кластере ClickHouse. * Вход: запрос (строка): SQL-запрос для выполнения. * Запросы по умолчанию выполняются в режиме только для чтения (CLICKHOUSE_ALLOW_WRITE_ACCESS=false), но запись может быть включена явно при необходимости. * list_databases * Перечислите все базы данных в вашем кластере ClickHouse. * list_tables * Список таблиц в базе данных с пагинацией. * Обязательный вход: база данных (строка). * Необязательные входы: * like / not_like (строка): Применить фильтры LIKE или NOT LIKE к именам таблиц. * page_token (строка): Токен, возвращаемый предыдущим вызовом для загрузки следующей страницы. * page_size (int, по умолчанию 50): Количество возвращаемых таблиц на странице. * include_detailed_columns (bool, по умолчанию true): При false опускается метаданные столбца для более лёгких ответов, сохраняя полный create_table_query. * Форма ответа: * таблицы: массив объектов таблицы для текущей страницы. * next_page_token: Передайте это значение обратно для получения следующей страницы или обнулите, когда таблиц больше нет.

Обзор (машинный перевод)

MCP-сервер для ClickHouse.

Сервер реализует MCP 2026-07-28 и поддерживает инициализацию наследственных рукопожатий от 2024-11-05 до 2025-11-25. Современные клиенты используют безсессионные запросы и server/discover. Существующие клиенты могут продолжать вести переговоры по устаревшему протоколу.

[! ПРИМЕЧАНИЕ] HTTP-запросы без MCP-Protocol-Version маршрутизируются через обработку устаревшей системы, поэтому клиенты до 2025-06-18 могут продолжать подключаться. Разрешения MCP 2026-07-28 такое поведение на серверах, поддерживающих этих клиентов. Современные клиенты должны отправлять заголовок для каждого запроса POST.

Особенности

Инструменты ClickHouse

Ответы инструментов ClickHouse — это строки, закодированные в JSON. Целые числа вне [-9007199254740991, 9007199254740991] возвращаются как десятичные строки для сохранения точных значения в JavaScript-клиентах. Это относится к строкам запросов и метаданным целочисленных таблиц. Безопасный диапазон Целые и булевые данные сохраняют свои JSON-типы.

  • run_query
  • Выполняйте SQL-запросы в вашем кластере ClickHouse.
  • Вход: query (строка): SQL-запрос для выполнения.
  • Необязательный вход: params (объект): Именованные значения для заполнятелей ClickHouse {name:Type}. См. параметры запроса.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

ClickHouse MCP Server

An MCP server for ClickHouse.

The server implements MCP 2026-07-28 and supports legacy initialize handshakes from 2024-11-05 through 2025-11-25. Modern clients use sessionless requests and server/discover. Existing clients can continue to negotiate the legacy protocol.

[!NOTE] HTTP requests without MCP-Protocol-Version are routed through legacy handling so clients from before 2025-06-18 can continue to connect. MCP 2026-07-28 permits this behavior on servers that support those clients. Modern clients should send the header on every POST request.

Features

ClickHouse Tools

ClickHouse tool responses are JSON-encoded strings. Integers outside [-9007199254740991, 9007199254740991] are returned as decimal strings to preserve exact values in JavaScript clients. This applies to query rows and integer table metadata. Safe-range integers and booleans keep their JSON types.

  • run_query

    • Execute SQL queries on your ClickHouse cluster.
    • Input: query (string): The SQL query to execute.
    • Optional input: params (object): Named values for ClickHouse {name:Type} placeholders. See Query parameters.
    • Queries run in read-only mode by default (CLICKHOUSE_ALLOW_WRITE_ACCESS=false), but writes can be enabled explicitly if needed.
    • DESCRIBE () and EXPLAIN ESTIMATE run here too and are optional ways to inspect a query’s result schema or its estimated reads. See Checking a query before running it.

  • 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): Single-use token returned by a previous call. It is retained for up to one hour.
      • page_size (int, default 50): Number of tables returned per page; must be greater than 0.
      • 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 single-use value back before it expires to fetch the next page, or null when there are no more tables.
      • total_tables: Total count of tables that match the supplied filters.

Agents Schema discovery

The server instructions suggest reading Agents Schema’s

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "mcp-clickhouse": { "url": "http://127.0.0.1:8000", "headers": { "Authorization": "Bearer your-generated-token" } } } }