ClickHouse

by @ClickHouse · io.github.ClickHouse/mcp-clickhouse

Official ClickHouse MCP server for querying and exploring ClickHouse clusters and chDB.

Verified makerRuns on your machineLocal
Category
Databases
Connection
Local (pypi)
Tools
Shown after install
Status
Runs on your computer

Connect it to your AI

Claude Code (pypi)

claude mcp add mcp-clickhouse -e CLICKHOUSE_HOST=… -e CLICKHOUSE_USER=… -- uvx mcp-clickhouse==0.7.0

Needs: CLICKHOUSE_HOST, CLICKHOUSE_USER

Claude Code (Docker)

claude mcp add mcp-clickhouse -e CLICKHOUSE_HOST=… -e CLICKHOUSE_USER=… -- docker run -i --rm ghcr.io/clickhouse/mcp-clickhouse:0.7.0

Needs: CLICKHOUSE_HOST, CLICKHOUSE_USER

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uvx",
      "args": [
        "mcp-clickhouse==0.7.0"
      ]
    }
  }
}

Questions

What is the ClickHouse MCP server?

Official ClickHouse MCP server for querying and exploring ClickHouse clusters and chDB. It is made by @ClickHouse and listed in the official MCP Registry as io.github.ClickHouse/mcp-clickhouse. MCP (Model Context Protocol) is the open standard that lets AI apps like Claude, ChatGPT and Cursor use outside tools.

How do I add ClickHouse to Claude?

In Claude Code, run: claude mcp add mcp-clickhouse -e CLICKHOUSE_HOST=… -e CLICKHOUSE_USER=… -- uvx mcp-clickhouse==0.7.0

How do I add ClickHouse to ChatGPT?

ChatGPT only connects to remote MCP servers, and ClickHouse runs on your own computer. Use it from Claude, Cursor or another app that runs local servers.

How do I add ClickHouse to Cursor?

Open Cursor settings, go to MCP, choose "Add new MCP server" (or edit ~/.cursor/mcp.json) and add: { "mcpServers": { "mcp-clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse==0.7.0" ] } } }

Does ClickHouse work right now?

It runs on your own computer, so it works once you install it. There is no remote server for us to check.

Is this your server? Get the badge for your README
chen.media/mcp badge

Markdown (GitHub README)

[![Verified maker on chen.media/mcp](https://chen.media/mcp/badge/github-clickhouse-mcp-clickhouse.svg?type=verified)](https://chen.media/mcp/github-clickhouse-mcp-clickhouse)

HTML (switches to dark mode on its own)

<a href="https://chen.media/mcp/github-clickhouse-mcp-clickhouse"><picture><source media="(prefers-color-scheme: dark)" srcset="https://chen.media/mcp/badge/github-clickhouse-mcp-clickhouse.svg?type=verified&theme=dark"><img src="https://chen.media/mcp/badge/github-clickhouse-mcp-clickhouse.svg?type=verified" alt="Verified maker on chen.media/mcp" height="40"></picture></a>

More in Databases

See all