MotherDuck MCP Server

Der MotherDuck MCP Server verbindet KI-Assistenten wie Claude, Cursor, die Gemini CLI oder GitHub Copilot mit MotherDuck, einem Cloud-Dienst für Datenanalyse auf Basis der Analysedatenbank DuckDB. Statt SQL-Abfragen selbst zu schreiben und Ergebnisse von Hand zu kopieren, stellen Sie dem Assistenten Fragen zu Ihren Tabellen: Er schaut sich die Struktur an, formuliert die passende Abfrage, führt sie aus und erklärt das Ergebnis. Betrieben wird der Server von MotherDuck selbst; er läuft gehostet und benötigt laut Dokumentation keine lokale Installation.

Was ist der MotherDuck MCP Server?

MotherDuck erweitert DuckDB um Speicher und Rechenleistung in der Cloud. Der MCP-Server macht diese Datenbanken für Assistenten zugänglich. Der Endpunkt lautet laut Dokumentation https://api.motherduck.com/mcp und nutzt HTTP als Transport. Neben diesem gehosteten Server gibt es ein quelloffenes Repository motherduckdb/mcp-server-motherduck unter MIT-Lizenz, das lokal läuft und auch lokale DuckDB-Dateien, In-Memory-Datenbanken oder Daten in S3 abfragen kann. Der gehostete Server kann dagegen nicht auf Ihr lokales Dateisystem zugreifen.

Welche Werkzeuge stehen zur Verfügung?

Der Server bietet laut Dokumentation Werkzeuge für schreibgeschützte und für schreibende SQL-Abfragen, außerdem zum Auflisten von Datenbanken, Tabellen und Spalten, zur Suche im Katalog und zum Beantworten von Fragen zur MotherDuck-Dokumentation. Das lokale Repository nennt dagegen fünf Werkzeuge, darunter execute_query, list_databases, list_tables und list_columns; Ergebnisse sind dort standardmäßig auf 1024 Zeilen und 50.000 Zeichen begrenzt, damit der Kontext des Assistenten nicht überläuft.

Wofür ist er besonders nützlich?

Der Nutzen liegt in der Erkundung unbekannter Daten. Wer eine neue Datenbank übernimmt, kann den Assistenten nach Tabellen, Spalten und typischen Auswertungen fragen und bekommt lauffähiges SQL im DuckDB-Dialekt, das sich prüfen und weiterverwenden lässt. Analysten sparen Zeit bei wiederkehrenden Abfragen, Entwicklerinnen und Entwickler prüfen im Editor schnell, was eine Pipeline geschrieben hat. Gegenüber einem allgemeinen Datenbankserver kennt dieser Server DuckDB-Besonderheiten und die Struktur des MotherDuck-Katalogs und kann mit seinen Dokumentationsfragen auch bei Syntaxproblemen helfen.

Einrichtung

Die Anmeldung erfolgt bei den meisten Clients per OAuth im Browser mit dem eigenen MotherDuck-Konto. Alternativ lässt sich ein MotherDuck-Zugriffstoken als Bearer-Header verwenden, etwa bei der Gemini CLI. Die Dokumentation beschreibt Schritte für Claude, ChatGPT, Cursor, Claude Code, Gemini CLI, Visual Studio Code mit GitHub Copilot und Copilot Studio. In den meisten Fällen genügt ein Eintrag mit der Adresse und dem Typ http in der Konfiguration des Clients.

Voraussetzungen, Sicherheit und Grenzen

Der Server setzt ein MotherDuck-Konto voraus. Wegen des schreibenden Werkzeugs sollten Sie die Rechte bewusst begrenzen: Die Dokumentation empfiehlt, das schreibende Werkzeug zu sperren oder zu deaktivieren, für gemeinsam genutzte Agenten einen Service-Account zu verwenden und ein Read-Scaling-Token einzusetzen. Das lesende Werkzeug kann dann bedenkenlos auf „immer erlauben“ gestellt werden, was die Erkundung beschleunigt. Abgerufene Daten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter. Für den lokalen Server betont das Repository, dass der schreibgeschützte Modus allein für den Zugriff durch Dritte nicht ausreicht; für produktive Szenarien wird der gehostete Server empfohlen.

Kosten

Der Server setzt ein MotherDuck-Konto voraus. Laut Preisseite gibt es einen kostenlosen Lite-Plan für Einzelne und Hobbyprojekte, einen kostenpflichtigen Business-Plan für den produktiven Betrieb und einen Enterprise-Tarif nach individueller Vereinbarung. Abgerechnet wird nach Rechenleistung, Speicher und, bei den bezahlten Plänen, einer Plattformgebühr. Welche Konditionen für Sie gelten, entnehmen Sie der offiziellen Preisseite von MotherDuck.

Für wen lohnt sich der MotherDuck MCP Server?

Er lohnt sich für Datenteams, Analysten und Entwickler, die bereits DuckDB oder MotherDuck einsetzen und Auswertungen im Gespräch mit einem Assistenten erledigen wollen. Wer mit lokalen Dateien arbeitet, ist mit dem quelloffenen lokalen Server besser bedient. Wer keine Daten in MotherDuck hat, gewinnt durch den gehosteten Server nichts: Er ist ein Zugang zur Plattform, kein eigenständiges Analysewerkzeug.

Ein MotherDuck-Konto (der kostenlose Lite-Plan genügt zum Ausprobieren) und ein MCP-Client mit Unterstützung für Remote-Server, etwa Claude, Cursor oder Claude Code.

Mit dem MotherDuck MCP Server fragt ein KI-Assistent Ihre DuckDB-Datenbanken in der Cloud ab. Dieser Ratgeber führt von der Anmeldung bis zur ersten Abfrage.

Schritt 1: Voraussetzungen prüfen

Sie benötigen ein MotherDuck-Konto und einen MCP-Client mit Unterstützung für Remote-Server, etwa Claude, Cursor oder Claude Code. Zum Ausprobieren genügt laut Preisseite der kostenlose Lite-Plan.

Schritt 2: Server eintragen

Der Endpunkt lautet https://api.motherduck.com/mcp. In Claude Code tragen Sie ihn mit claude mcp add --transport http motherduck https://api.motherduck.com/mcp ein. In anderen Clients genügt in der Konfiguration ein Eintrag mit der Adresse und dem Typ http.

claude mcp add --transport http motherduck https://api.motherduck.com/mcp

Schritt 3: Anmelden

Beim ersten Verbinden öffnet der Client den Browser, und Sie bestätigen den Zugriff per OAuth mit Ihrem MotherDuck-Konto. Bei der Gemini CLI wird stattdessen ein Zugriffstoken als Header übergeben; legen Sie es in einer Umgebungsvariable ab, nie im Repository.

Schreibzugriff begrenzen

Der Server hat ein lesendes und ein schreibendes SQL-Werkzeug. Sperren Sie das schreibende Werkzeug im Client, wenn der Assistent nur auswerten soll. Für gemeinsam genutzte Agenten empfiehlt die Dokumentation einen Service-Account und ein Read-Scaling-Token.

Schritt 4: Erste Abfragen

Beginnen Sie mit Fragen wie „Welche Datenbanken und Tabellen gibt es?“ oder „Welche Spalten hat die Tabelle orders?“. Danach lassen Sie Auswertungen formulieren, etwa Umsatz je Monat. Prüfen Sie das erzeugte SQL stichprobenartig.

Schritt 5: Lokaler Server für Dateien

Wollen Sie lokale DuckDB-Dateien oder Daten in S3 abfragen, nutzen Sie das quelloffene Repository mit uvx mcp-server-motherduck --db-path <Pfad>. Ohne das Flag --read-write ist der Zugriff schreibgeschützt.

uvx mcp-server-motherduck --db-path <Pfad>

OAuth über den Browser mit dem eigenen MotherDuck-Konto; alternativ ein MotherDuck-Zugriffstoken als Bearer-Header.

Lesender und schreibender SQL-Zugriff auf die Datenbanken des angemeldeten Kontos; das schreibende Werkzeug lässt sich im Client sperren.

Der Server läuft gehostet bei MotherDuck. Abgerufene Daten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Ungewollte Schreib- oder Löschbefehle über das schreibende Werkzeug, Weitergabe von Geschäftsdaten an den Modellanbieter und ein im Repository abgelegtes Zugriffstoken.