Track MCP LogoTrack MCP
Track MCP LogoTrack MCP

The world's largest repository of Model Context Protocol servers. Discover, explore, and submit MCP tools.

Product

  • Categories
  • Top MCP
  • New & Updated
  • Submit MCP

Company

  • About

Legal

  • Privacy Policy
  • Terms of Service
  • Cookie Policy

© 2026 TrackMCP. All rights reserved.

Built with ❤️ by Krishna Goyal

    Clickhouse Mcp

    0 stars
    Go
    Updated Apr 1, 2025

    Table of Contents

    • Возможности
    • Структура проекта
    • Использование
    • Сборка
    • Запуск
    • Запуск в Docker
    • Запуск с Docker Compose
    • Параметры командной строки
    • Формат запросов и ответов
    • Запрос на получение списка баз данных
    • Запрос на получение списка таблиц
    • Запрос на получение схемы таблицы
    • Запрос на выполнение SQL запроса
    • Настройка MCP клиента
    • Настройка MCP клиента c SSE
    • Лицензия
    • Вклад в проект
    • Контакты
    • Спасибо

    Table of Contents

    • Возможности
    • Структура проекта
    • Использование
    • Сборка
    • Запуск
    • Запуск в Docker
    • Запуск с Docker Compose
    • Параметры командной строки
    • Формат запросов и ответов
    • Запрос на получение списка баз данных
    • Запрос на получение списка таблиц
    • Запрос на получение схемы таблицы
    • Запрос на выполнение SQL запроса
    • Настройка MCP клиента
    • Настройка MCP клиента c SSE
    • Лицензия
    • Вклад в проект
    • Контакты
    • Спасибо

    Documentation

    ClickHouse MCP сервер

    Go Version

    License

    Coverage

    MCP-совместимый сервер для взаимодействия с ClickHouse базами данных.

    Возможности

    • Получение списка баз данных
    • Получение списка таблиц в выбранной базе данных
    • Получение схемы выбранной таблицы
    • Выполнение SQL запросов и получение результатов
    • Поддержка разных транспортов (stdio и SSE)

    Структура проекта

    tree
    clickhouse-mcp/
    ├── app/            # Основная логика приложения
    │   └── server.go   # Настройка и запуск сервера
    ├── clickhouse/     # Пакет для работы с ClickHouse
    │   └── client.go   # Клиент ClickHouse
    ├── mcp/            # Работа с протоколом MCP
    │   └── tools.go    # Инструменты MCP
    └── main.go         # Точка входа

    Использование

    Сборка

    bash
    go build -o clickhouse-mcp

    Запуск

    Запуск через stdio (по умолчанию):

    bash
    ./clickhouse-mcp -url localhost:9000/default -user default -password yourpassword

    Запуск через SSE:

    bash
    ./clickhouse-mcp -t sse -url localhost:9000/default -user default -password yourpassword

    Запуск в тестовом режиме:

    bash
    ./clickhouse-mcp -test

    Запуск в Docker

    bash
    docker build -t clickhouse-mcp .
    docker run -d -p 8080:8080 --name clickhouse-mcp \
      -e CLICKHOUSE_URL=host.docker.internal:9000/default \
      -e CLICKHOUSE_USER=default \
      -e CLICKHOUSE_PASSWORD=yourpassword \
      clickhouse-mcp:latest

    Запуск с Docker Compose

    bash
    # Запуск со стандартным портом 8080
    docker-compose up -d
    
    # Запуск с пользовательским портом и другими параметрами
    PORT=9090 CLICKHOUSE_URL=host.docker.internal:9000/mydatabase docker-compose up -d

    В Windows:

    powershell
    $env:PORT=8082; $env:CLICKHOUSE_URL="host.docker.internal:9000"; $env:CLICKHOUSE_USER="default" ; $env:CLICKHOUSE_PASSWORD="yourpassword"; $env:CLICKHOUSE_DB="default"; $env:CLICKHOUSE_SECURE=false; docker-compose up -d

    Параметры командной строки

    • -t, -transport: Тип транспорта (stdio или sse), по умолчанию stdio
    • -test: Запуск в тестовом режиме (показывает примеры запросов)
    • -url: URL ClickHouse в формате хост:порт/база_данных
    • -user: Имя пользователя ClickHouse, по умолчанию "default"
    • -password: Пароль пользователя ClickHouse
    • -db: База данных ClickHouse (переопределяет базу в URL)
    • -secure: Использовать TLS соединение

    Формат запросов и ответов

    Запрос на получение списка баз данных

    json
    {
      "jsonrpc": "2.0",
      "id": "test",
      "method": "mcp.call",
      "params": {
        "tool": "get_databases",
        "arguments": {}
      }
    }

    Запрос на получение списка таблиц

    json
    {
      "jsonrpc": "2.0",
      "id": "test",
      "method": "mcp.call",
      "params": {
        "tool": "get_tables",
        "arguments": {
          "database": "default"
        }
      }
    }

    Запрос на получение схемы таблицы

    json
    {
      "jsonrpc": "2.0",
      "id": "test",
      "method": "mcp.call",
      "params": {
        "tool": "get_schema",
        "arguments": {
          "database": "default",
          "table": "my_table"
        }
      }
    }

    Запрос на выполнение SQL запроса

    json
    {
      "jsonrpc": "2.0",
      "id": "test",
      "method": "mcp.call",
      "params": {
        "tool": "query",
        "arguments": {
          "query": "SELECT * FROM default.my_table",
          "limit": 10
        }
      }
    }

    Настройка MCP клиента

    json
    {
      "mcpServers": {
        "clickhouse": {
          "command": "/path/to/clickhouse-mcp",
          "args": ["-url", "localhost:9000/default", "-user", "default", "-password", "yourpassword"],
          "disabled": false,
          "alwaysAllow": []
        }
      }
    }

    Настройка MCP клиента c SSE

    json
    {
      "mcpServers": {
        "clickhouse": {
          "url": "http://localhost:8080/sse",
          "env": {
            "API_KEY": ""
          }
        }
      }
    }

    Лицензия

    MIT License. См. файл LICENSE для подробностей.

    Вклад в проект

    1. Форкните репозиторий

    2. Создайте ветку для ваших изменений

    3. Внесите изменения и создайте pull request

    Контакты

    Создайте issue в репозитории для сообщения о проблемах или предложений по улучшению.

    Спасибо

    • @Headcrab

    Similar MCP

    Based on tags & features

    • MC

      Mcpjungle

      Go·
      617
    • AN

      Anyquery

      Go·
      1.4k
    • YU

      Yutu

      Go·
      317
    • MC

      Mcp Cyclops

      Go·
      29

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k
    View All MCP Servers

    Similar MCP

    Based on tags & features

    • MC

      Mcpjungle

      Go·
      617
    • AN

      Anyquery

      Go·
      1.4k
    • YU

      Yutu

      Go·
      317
    • MC

      Mcp Cyclops

      Go·
      29

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScript·
      22.1k
    • SE

      Serena

      Python·
      14.5k
    • MC

      Mcp Playwright

      TypeScript·
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScript·
      3.0k