mcp-clickhousemcp-clickhouse MCP-Server

— (0)

Geprüft von Daniel Nikulshyn·Aktualisiert Juni 2026

Übersicht

Der mcp-clickhouse MCP-Server ist ein MCP-Server für ClickHouse. Er bietet ClickHouse-Tools, darunter run_query zum Ausführen von SQL-Abfragen auf Ihrem ClickHouse-Cluster, list_databases zum Auflisten aller Datenbanken auf Ihrem ClickHouse-Cluster und list_tables zum Auflisten von Tabellen in einer Datenbank mit Pagination. Zusätzlich enthält er chDB-Tools wie run_chdb_select_query, um SQL-Abfragen mithilfe des eingebetteten ClickHouse-Engines von chDB auszuführen. Er stellt außerdem einen Health-Check-Endpunkt zur Überwachung der Servergesundheit und einen Sicherheitsmechanismus für die Authentifizierung bereit. Der Server lässt sich für interne Dienste, lokale Entwicklung oder mit OAuth/OIDC-Authentifizierungsanbietern über FastMCP einrichten.

Hauptfunktionen

run_query zum Ausführen von SQL-Abfragen auf einem ClickHouse-Cluster
list_databases zum Auflisten aller Datenbanken auf einem ClickHouse-Cluster
list_tables zum Auflisten von Tabellen in einer Datenbank mit Pagination
run_chdb_select_query zum Ausführen von SQL-Abfragen mithilfe des eingebetteten ClickHouse-Engines von chDB
Health-Check-Endpunkt zur Überwachung des Servers
Mehrere Authentifizierungsmodi, einschließlich OAuth und OIDC über FastMCP

Preise

Modell: Free
Kategorie: MCP-Server
Bewertung: Noch keine Bewertungen

Anwendungsfälle

Überwachung der Servergesundheit von ClickHouse

Nutzen Sie den Health-Check-Endpunkt, um die Gesundheit des Servers zu überwachen und eventuelle Probleme zu erkennen.

Ausführen von SQL-Abfragen auf ClickHouse

Verwenden Sie die ClickHouse-Tools, wie run_query, um SQL-Abfragen auf Ihrem ClickHouse-Cluster auszuführen.

Absicherung des ClickHouse-Servers

Implementieren Sie Authentifizierung und Autorisierung mithilfe der unterstützten Modi, einschließlich OAuth und OIDC über FastMCP.

Pro & Contra

Pro

Ermöglicht das Ausführen von SQL-Abfragen auf einem ClickHouse-Cluster
Unterstützt mehrere Authentifizierungsmodi, einschließlich OAuth und OIDC
Verfügt über einen integrierten Health-Check-Endpunkt zur Serverüberwachung

Contra

Nur für interne Dienste geeignet wegen Sicherheitsbedenken
Eingeschränkte Flexibilität bei der Ausführung von Abfragen
Erfordert eine korrekte Konfiguration von Authentifizierung und Autorisierung

Schlacht-Bilanz

Aus 1 Schlacht im Pantheon.

Last battle

#3
MCP Servers Showdown — May 26, 2026
May 26, 2026 · #3 of 5

Bewertungen

Melde dich an, um eine Bewertung abzugeben.

Noch keine Bewertungen. Sei die/der Erste!

Fragen & Antworten

Can mcp-clickhouse execute write queries on the ClickHouse cluster?

Queries run in read‑only mode by default (`CLICKHOUSE_ALLOW_WRITE_ACCESS=false`). Write access can be enabled explicitly if needed, allowing `run_query` to execute INSERT or UPDATE statements when the server is configured to permit writes.

Asked by Celia Ramirez · Aug 6, 2025

What pagination options are available when listing tables in a database?

The `list_tables` tool supports pagination via `page_token` and `page_size` parameters. By default it returns 50 tables per page, but you can adjust `page_size` and use the returned `next_page_token` to fetch subsequent pages, optionally filtering with `like` or `not_like`.

Asked by Marisol Pena · Jul 31, 2025

How can I monitor the health of the mcp-clickhouse server in a Kubernetes environment?

The server exposes an unauthenticated health check endpoint at `/health` that returns `200 OK` with body `OK` when it can connect to ClickHouse, and `503 Service Unavailable` otherwise. This endpoint is designed for liveness/readiness probes in Kubernetes or load balancer checks.

Asked by Kwame Mensah · Jul 8, 2025

What authentication methods does mcp-clickhouse support and how are they configured?

mcp-clickhouse supports multiple authentication modes, including OAuth and OIDC via FastMCP, as well as internal service authentication. Configuration is done through the FastMCP settings in the server’s JSON configuration, allowing you to enable the desired provider and set required credentials.

Asked by Stella Papadopoulos · Jun 21, 2025