mcp-clickhousex MCP Server

A read-only-by-default Model Context Protocol (MCP) server for ClickHouse that provides schema discovery, read-only queries, execution-plan analysis, opt-in writes, and profile-based access to…

Local serverstdio

What is the mcp-clickhousex MCP Server?

mcp-clickhousex is an MCP project maintained in the alyiox/mcp-clickhousex repository. The maintainer describes its purpose as “A read-only-by-default Model Context Protocol (MCP) server for ClickHouse that provides schema discovery, read-only queries, execution-plan analysis, opt-in writes, and profile-based access to multiple servers…”. Read the project documentation for the complete scope.

Installation

The documented pypi package is mcp-clickhousex. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares MCP_CLICKHOUSE_DSN. 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.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
URIDescription

How to install the mcp-clickhousex MCP Server

{
  "mcpServers": {
    "clickhouse": {
      "command": "uvx",
      "args": [
        "mcp-clickhousex"
      ],
      "env": {
        "MCP_CLICKHOUSE_DSN": "http://default:@localhost:8123/default"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
MCP_CLICKHOUSE_DSNDeclared in the maintainer’s client configuration.Check documentation