ClickHouse-Connector

Stellt ClickHouse als stdio-MCP-Server mit execute_sql bereit. Der Connector nutzt das native ClickHouse-Protokoll, nicht den HTTP-Endpunkt, und baut bei Bedarf eine clickhouse://-DSN aus Flags oder Umgebungsvariablen. CLI-Flags haben Vorrang.

Flags

Flag	Umgebungsvariable	Standard	Beschreibung
--host	CLICKHOUSE_HOST	localhost	ClickHouse-Host
--port	CLICKHOUSE_PORT	9000	Nativer Protokoll-Port, nicht HTTP-Port 8123
--user	CLICKHOUSE_USER	default	Benutzername
--password	CLICKHOUSE_PASSWORD		Passwort
--database	CLICKHOUSE_DATABASE	default	Datenbankname
--secure	CLICKHOUSE_SECURE	false	TLS für die ClickHouse-Verbindung aktivieren.
--dsn	CLICKHOUSE_DSN		Vollständige DSN-URL; überschreibt alle Einzelwerte

Verwendung

# Mit CLI-Flags
ai-hub-cli mcp ai-hub-cli clickhouse-connector \
  --host localhost --port 9000 \
  --user default --password meinpass --database default

# Mit Umgebungsvariablen
export CLICKHOUSE_HOST=localhost
export CLICKHOUSE_PORT=9000
export CLICKHOUSE_USER=default
export CLICKHOUSE_PASSWORD=meinpass
export CLICKHOUSE_DATABASE=default
ai-hub-cli mcp ai-hub-cli clickhouse-connector

# Mit DSN
ai-hub-cli mcp ai-hub-cli clickhouse-connector \
  --dsn "clickhouse://user:password@localhost:9000/default?secure=false"

MCP-Tool: execute_sql — akzeptiert beliebige ClickHouse-SQL-Statements. Ergebnisse werden als JSON-Zeilen zurückgegeben.

Nutze Port 9000 für das native Binärprotokoll, nicht den HTTP-Port 8123.

MCP-Toolparameter

Parameter	Pflicht	Beschreibung
query	Ja	ClickHouse-SQL-Statement.
connection_id	Nein	Logischer Verbindungsname. Leerlassen nutzt default; gleiche IDs behalten den Connection-Pool.