Clickzetta MCP Server
Überblick
Eine Model Context Protocol (MCP)-Serverimplementierung, die die Datenbankinteraktion mit Clickzetta Lakehouse ermöglicht. Dieser Server ermöglicht die Ausführung von SQL-Abfragen mit Tools und die Interaktion mit einem Memo mit Datenerkenntnissen, das als Ressource bereitgestellt wird.
Schnellstart mit MCP-ClickZetta-Server/Trae als Ihrem AI Data Engineer
Laden Sie Trae herunter und installieren Sie es
Laden Sie es von trae.ai herunter und melden Sie sich an, um die Verwendung von KI zu ermöglichen.
Holen Sie sich Ihr ClickZetta-Konto
Holen Sie sich Ihr ClickZetta-Konto
MCP-ClickZetta-Server Docker Image abrufen
MCP-Server in Trae hinzufügen
- Klicken Sie im KI-Chatfenster auf das Symbol „Einstellungen“ > „MCP“.
- Das MCP-Fenster wird angezeigt.
- Klicken Sie auf die Schaltfläche + Hinzufügen.
- Sie gelangen zum MCP Server Marketplace.
- Klicken Sie auf „Manuelle Konfiguration“. Das Fenster „Manuelle Konfiguration“ wird angezeigt. Fügen Sie einen neuen MCP-Server hinzu, indem Sie die folgende JSON-Konfiguration in das Eingabefeld einfügen und anschließend auf „Bestätigen“ klicken. Der MCP-Server wird der MCP-Liste hinzugefügt.
- CLICKZETTA开头的env参数为必填
Schnellstart mit MCP-ClickZetta-Server/Zettapark-MCP-Server/Claude Desktop als Ihr AI Data Engineer
Laden Sie Claude Desktop herunter und installieren Sie es
Laden Sie es von claude.ai herunter und melden Sie sich an.
Holen Sie sich Ihr ClickZetta-Konto
Holen Sie sich Ihr ClickZetta-Konto
Starten Sie Ihr Jupyter-Labor
Beginnen Sie mit Docker Compose
- Ordner erstellen
- Erstellen Sie die Datei config.json und legen Sie Ihre Anmeldeinformationen wie folgt fest:
Hinweis: Legen Sie dazu die Datei config.json im Ordner „Notebooks“ ab. Ändern Sie „query_tag“ entsprechend Ihrem Zweck und verwenden Sie es, um die Abfrage anhand des Tags zu finden.
- Laden Sie docker-compose.yml herunter und starten Sie Docker Compose
Laden Sie die Docker Compose-Datei hier herunter
Gehen Sie zum Docker-Desktop und überprüfen Sie, ob Docker Compose gestartet ist.
- Zugriff auf den Jupyter Lab Server
Token: IHR_SICHERES_TOKEN
Erstellen Sie dann ein neues Notizbuch und ändern Sie den Namen von Untitled.ipynb in notebook.ipynb.
Oder starten Sie den lokalen Server
Fügen Sie den MCP-Server zu Ihrem Claude Desktop hinzu
- Gehen Sie in Claude Desktop zu Einstellungen → Entwickler → Konfiguration bearbeiten
- Öffnen Sie claude_desktop_config.json und konfigurieren Sie MCP-Server
Weitere ausführliche Informationen zum Zettapark MCP-Server erhalten Sie hier .
Komponenten
Ressourcen
Der Server stellt eine einzelne dynamische Ressource bereit:
memo://insights
: Ein kontinuierlich aktualisiertes Dateneinblicksmemo, das die während der Analyse gewonnenen Erkenntnisse zusammenfasst- Automatische Aktualisierungen, wenn über das Append-Insight-Tool neue Erkenntnisse gewonnen werden
Werkzeuge
Der Server bietet die folgenden Kerntools:
Abfragetools
read_query
- Beschreibung : Führen Sie
SELECT
-Abfragen aus, um Daten aus der Datenbank zu lesen. - Eingabe :
query
(Zeichenfolge): Die auszuführendeSELECT
-SQL-Abfrage.
- Gibt zurück : Abfrageergebnisse als Array von Objekten.
write_query
(erfordert das Flag --allow-write
)
- Beschreibung : Führen Sie
INSERT
,UPDATE
oderDELETE
-Abfragen aus, um Daten zu ändern. - Eingabe :
query
(Zeichenfolge): Die SQL-Änderungsabfrage.
- Gibt zurück :
{ affected_rows: number }
, was die Anzahl der betroffenen Zeilen angibt.
create_table
(erfordert das Flag --allow-write
)
- Beschreibung : Erstellen Sie neue Tabellen in der Datenbank.
- Eingabe :
query
(Zeichenfolge): SQL-AnweisungCREATE TABLE
.
- Rückgabe : Bestätigung der Tabellenerstellung.
create_table_with_prompt
(erfordert das Flag --allow-write
)
- Beschreibung : Erstellen Sie eine neue Tabelle, indem Sie den Benutzer nach Tabellenname, Spalten und deren Typen fragen.
- Eingabe :
table_name
(Zeichenfolge): Der Name der zu erstellenden Tabelle.columns
(Zeichenfolge): Die Spalten und ihre Typen im Formatcolumn1:type1,column2:type2
.
- Rückgabe : Bestätigung der Tabellenerstellung.
Schema-Tools
list_tables
- Beschreibung : Rufen Sie eine Liste aller Tabellen in der Datenbank ab.
- Eingabe : Keine Eingabe erforderlich.
- Gibt zurück : Ein Array von Tabellennamen.
describe_table
- Beschreibung : Spalteninformationen für eine bestimmte Tabelle anzeigen.
- Eingabe :
table_name
(Zeichenfolge): Name der zu beschreibenden Tabelle (kann vollständig qualifiziert sein).
- Gibt zurück : Ein Array von Spaltendefinitionen mit Namen und Typen.
show_object_list
- Beschreibung : Ruft die Liste bestimmter Objekttypen im aktuellen Arbeitsbereich ab, z. B. Kataloge, Schemata, Tabellen usw.
- Eingabe :
object_type
(Zeichenfolge): Der Typ des anzuzeigenden Objekts.
- Gibt zurück : Eine Liste von Objekten.
desc_object
- Beschreibung : Erhalten Sie detaillierte Informationen zu einem bestimmten Objekt, beispielsweise einem Katalog, Schema oder einer Tabelle.
- Eingabe :
object_type
(Zeichenfolge): Der Typ des Objekts.object_name
(Zeichenfolge): Der Name des Objekts.
- Gibt zurück : Detaillierte Informationen zum Objekt.
Analysetools
append_insight
- Beschreibung : Fügen Sie der Memo-Ressource neue Dateneinblicke hinzu.
- Eingabe :
insight
(Zeichenfolge): Durch Analyse gewonnene Dateneinblicke.
- Rückgabe : Bestätigung der hinzugefügten Erkenntnisse.
- Auslöser : Aktualisiert die Ressource
memo://insights
.
Datenimport-Tools
import_data_into_table_from_url
- Beschreibung : Importieren Sie Daten von einer URL (einschließlich Dateipfaden oder HTTP/HTTPS-URLs) in eine Tabelle. Falls die Zieltabelle nicht existiert, wird sie automatisch erstellt.
- Eingabe :
from_url
(Zeichenfolge): Die URL der Datenquelle.dest_table
(Zeichenfolge): Die Tabelle, in die Daten importiert werden sollen.
- Rückgabe : Bestätigung des erfolgreichen Datenimports.
import_data_into_table_from_database
- Beschreibung : Stellen Sie eine Verbindung zu einer Datenbank her, führen Sie eine Abfrage aus und importieren Sie die Ergebnisse in eine Clickzetta-Tabelle. Unterstützt MySQL, PostgreSQL, SQLite und andere gängige Datenbanktypen.
- Eingabe :
db_type
(Zeichenfolge): Der Typ der Datenbank (z. B.mysql
,postgresql
,sqlite
).host
(Zeichenfolge): Der Hostname oder die IP-Adresse des Datenbankservers (für SQLite nicht erforderlich).port
(Ganzzahl): Die Portnummer des Datenbankservers (für SQLite nicht erforderlich).database
(Zeichenfolge): Der Name der Datenbank, mit der eine Verbindung hergestellt werden soll (bei SQLite ist dies der Dateipfad zur Datenbankdatei).username
(Zeichenfolge): Der Benutzername für die Authentifizierung (für SQLite nicht erforderlich).password
(Zeichenfolge): Das Passwort für die Authentifizierung (für SQLite nicht erforderlich).source_table
(Zeichenfolge): Der Name der Quelltabelle.dest_table
(Zeichenfolge): Der Name der Zieltabelle.
- Rückgabe : Bestätigung des erfolgreichen Datenimports.
Ähnliche Suchwerkzeuge
vector_search
- Beschreibung : Führen Sie mithilfe einer Frage eine Vektorsuche in einer Tabelle durch und geben Sie die fünf am besten passenden Antworten zurück.
- Eingabe :
table_name
(Zeichenfolge): Der Tabellenname.content_column_name
(Zeichenfolge): Die Spalte, in der der Inhalt gespeichert wird.embedding_column_name
(Zeichenfolge): Die Spalte, in der Einbettungen gespeichert werden.partition_scope
(Zeichenfolge): SQL-Code zum Definieren des Partitionsbereichs als Teil derWHERE
-Bedingung.question
(Zeichenfolge): Die zu suchende Frage.
- Gibt zurück : Suchergebnisse.
match_all
- Beschreibung : Führen Sie mit der Funktion „Alles abgleichen“ eine Suche in einer Tabelle mit einer Frage durch und geben Sie die fünf besten Antworten zurück.
- Eingabe :
table_name
(Zeichenfolge): Der Tabellenname.content_column_name
(Zeichenfolge): Die Spalte, in der der Inhalt gespeichert wird.partition_scope
(Zeichenfolge): SQL-Code zum Definieren des Partitionsbereichs als Teil derWHERE
-Bedingung.question
(Zeichenfolge): Die zu suchende Frage.
- Gibt zurück : Suchergebnisse.
Tools zur Wissenssuche
get_knowledge_about_how_to_do_something
- Beschreibung : Bietet Anleitungen zum Ausführen bestimmter Aufgaben, z. B. zum Analysieren langsamer Abfragen, zum Erstellen von Tabellen oder zum Verwalten von Speicherverbindungen.
- Eingabe :
to_do_something
(Zeichenfolge): Die auszuführende Aufgabe. Unterstützte Aufgaben sind:analyze_slow_query
analyze_table_with_small_file
create_table_syntax
how_to_create_vcluster
how_to_create_index
how_to_alter_table_and_column
how_to_create_storage_connection
how_to_create_external_volume
- Rückgabe : Detaillierte Anleitung zur angegebenen Aufgabe.
Verwendungshinweise
- Stellen Sie sicher, dass das Flag
--allow-write
aktiviert ist, wenn Sie Tools verwenden, die Daten ändern (z. B.write_query
,create_table
). - Geben Sie für jedes Tool die richtigen Eingabeparameter an, wie oben beschrieben.
Verwendung mit Claude Desktop
Installation als lokaler MCP-Server (Diese Methode wurde unter MacOS getestet und verifiziert)
Klonen Sie dieses Repository:
Installieren Sie das Paket:
Konfigurations-Anmeldeinformationen
Erstellen Sie eine .env-Datei basierend auf .env.example mit Ihren Clickzetta Lakehouse-Anmeldeinformationen:
Verwendung
Laufen mit UV
Nach der Installation des Pakets können Sie den Server direkt ausführen mit:
Wenn Sie den Server zum ersten Mal ausführen, können Sie den folgenden Befehl ausführen, um die Paketinstallation zu beschleunigen:
Dadurch wird der stdio-basierte MCP-Server gestartet, der mit Claude Desktop oder jedem MCP-Client verbunden werden kann, der die stdio-Kommunikation unterstützt.
Sie sollten eine Ausgabe ähnlich der folgenden sehen:
Claude Desktop Integration
Der MCP-Server (der in Docker ausgeführt wird) liest seine Konfiguration aus Umgebungsvariablen, die über die MCP-Clientkonfiguration übergeben werden (z. B. claude_desktop_config.json
). Wichtige Variablen:
- Gehen Sie in Claude Desktop zu Einstellungen → MCP-Server
- Fügen Sie einen neuen Server mit dem vollständigen Pfad zu Ihrer ausführbaren UV-Datei hinzu:
- Sie können Ihren UV-Pfad finden, indem Sie „which uv“ in Ihrem Terminal ausführen.
- Speichern der Serverkonfiguration
Beispielabfragen
Bei der Verwendung mit Claude können Sie Fragen stellen wie:
- „Können Sie alle Schemata in meinem Clickzetta-Konto auflisten?“
- „Alle Ansichten im PUBLIC-Schema auflisten“
- „Beschreiben Sie die Struktur der Ansicht CUSTOMER_ANALYTICS im Schema SALES.“
- „Zeigen Sie mir Beispieldaten aus der Ansicht REVENUE_BY_REGION im Schema FINANCE“
- „Führen Sie diese SQL-Abfrage aus: SELECT customer_id, SUM(order_total) as total_spend FROM SALES.ORDERS GROUP BY customer_id ORDER BY total_spend DESC LIMIT 10“
- „Fragen Sie die MARKETING-Datenbank ab, um die fünf leistungsstärksten Kampagnen nach Konversionsrate zu finden.“
- „Die Website von Clickzetta ist eine öffentliche Website mit öffentlichem Schema und Git „hub_users“
- „Sie haben Clickzetta 中读取数据, 分析下在public这个schema下github_event_issuesevent表里有多少条记录?“
Beispielergebnis
- Klicken Sie auf Clickzetta chema下github_users表里的数据可以做哪些分析?包括指标、统计、趋势、以及各种经典的用户分析模型比如用户价值分析、用户生命周期分析、用户segment等,然后根据这些分析内容生成一个分析报告的dashboard'
- Das Ergebnis von „Die Veröffentlichung von Clickzetta und der öffentliche Zugriff auf das Schema von Gith „ub_users“:
- Das Ergebnis von „帮我从Clickzetta中读取数据,分析下在public这个schema下github_users表里每个位置"
Sicherheitsüberlegungen
Dieser Server:
- Erzwingt schreibgeschützte Operationen (nur SELECT-Anweisungen sind zulässig)
- Fügt automatisch LIMIT-Klauseln hinzu, um große Ergebnismengen zu verhindern
- Verwendet die Dienstkontoauthentifizierung für sichere Verbindungen
- Validiert Eingaben, um SQL-Injection zu verhindern
- ⚠️ Wichtig: Bewahren Sie Ihre .env-Datei sicher auf und übergeben Sie sie niemals der Versionskontrolle. Die .gitignore-Datei ist so konfiguriert, dass sie ausgeschlossen ist.
Installation über Smithery (Diese Methode muss getestet und überprüft werden)
So installieren Sie Clickzetta Server für Claude Desktop automatisch über Smithery :
Installation über UVX (Dieser Weg muss getestet und überprüft werden)
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Ein Model Context Protocol-Server, der die Datenbankinteraktion mit Clickzetta ermöglicht und es Benutzern ermöglicht, SQL-Abfragen auszuführen, Tabellen zu verwalten und ein dynamisch aktualisiertes Memo mit Datenerkenntnissen zu pflegen.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables SQL query execution, database management, and business intelligence capabilities through MySQL connections.Last updated -JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that provides database interaction capabilities through SQLite, enabling users to run SQL queries, analyze business data, and automatically generate business insight memos.Last updated -69TypeScriptMIT License
- -security-license-qualityA Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.Last updated -Python
- -securityFlicense-qualityA Model Context Protocol server that enables SQL operations (SELECT, INSERT, UPDATE, DELETE) and table management through a standardized interface with SQLite databases.Last updated -JavaScript