Mcp-clickhouse MCP Server

A Model Context Protocol server for ClickHouse. It lets an MCP-capable client (Claude Desktop, Claude Code, etc.) explore schemas, run analytical queries, and manage the database — with behaviour…

Local serverstdioMIT

What is the Mcp-clickhouse MCP Server?

mcp-clickhouse is an MCP project maintained in the dockndevai/mcp-clickhouse repository. The maintainer describes its purpose as “A Model Context Protocol server for ClickHouse. It lets an MCP-capable client (Claude Desktop, Claude Code, etc.) explore schemas, run analytical queries, and manage the…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @dockndevai/mcp-clickhouse. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares CLICKHOUSE_URL, CLICKHOUSE_USER, CLICKHOUSE_MODE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the Mcp-clickhouse MCP Server

{
  "mcpServers": {
    "clickhouse": {
      "command": "npx",
      "args": [
        "-y",
        "@dockndevai/mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_URL": "http://localhost:8123",
        "CLICKHOUSE_USER": "default",
        "CLICKHOUSE_MODE": "read-only"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
CLICKHOUSE_URLDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_USERDeclared in the maintainer’s client configuration.Check documentation
CLICKHOUSE_MODEDeclared in the maintainer’s client configuration.Check documentation