Official ClickHouse MCP Server

Official ClickHouse MCP Server

Official ClickHouse MCP Server.

9.5K

2

3 Tools

Signed
Built by Docker
Requires Secrets
Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

About

Official ClickHouse MCP Server MCP Server

Official ClickHouse MCP Server.

What is an MCP Server?

Characteristics

AttributeDetails
Docker Imagemcp/clickhouse
AuthorClickHouse
Repositoryhttps://github.com/ClickHouse/mcp-clickhouse
Dockerfilehttps://github.com/ClickHouse/mcp-clickhouse/blob/main/Dockerfile
Docker Image built byDocker Inc.
Docker Scout Health ScoreDocker Scout Health Score
Verify SignatureCOSIGN_REPOSITORY=mcp/signatures cosign verify mcp/clickhouse --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
LicenceApache License 2.0

Available Tools (3)

Tools provided by this ServerShort Description
list_databasesList available ClickHouse databases
list_tablesList available ClickHouse tables in a database, including schema, comment, row count, and column count.
run_select_queryRun a SELECT query in a ClickHouse database

Tools Details

Tool: list_databases

List available ClickHouse databases

Tool: list_tables

List available ClickHouse tables in a database, including schema, comment, row count, and column count.

ParametersTypeDescription
databasestring
likestringoptional
not_likestringoptional

Tool: run_select_query

Run a SELECT query in a ClickHouse database

ParametersTypeDescription
querystring

Use this MCP Server

{
  "mcpServers": {
    "clickhouse": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CLICKHOUSE_HOST",
        "-e",
        "CLICKHOUSE_PORT",
        "-e",
        "CLICKHOUSE_USER",
        "-e",
        "CLICKHOUSE_SECURE",
        "-e",
        "CLICKHOUSE_VERIFY",
        "-e",
        "CLICKHOUSE_CONNECT_TIMEOUT",
        "-e",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT",
        "-e",
        "CLICKHOUSE_PASSWORD",
        "mcp/clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_PORT": "8443",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30",
        "CLICKHOUSE_PASSWORD": "<YOUR_CLICKHOUSE_PASSWORD_HERE>"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?

Manual installation

You can install the MCP server using:

Installation for

Related servers