Für Agenten

MCP-Server

Vierzig Werkzeuge über stdio, damit der Assistent, mit dem du ohnehin sprichst, deine Datenbankarbeit erledigt statt sie zu beschreiben.

01

Was das ist

Ein Server für das Model Context Protocol, veröffentlicht als @capydb/mcp. Er spricht stdio, läuft lokal und ruft dieselbe Steuerebenen-API auf wie Dashboard und CLI - mit derselben Organisationsbindung, denselben Berechtigungen und derselben Prüfspur.

Er bringt einen handgeschriebenen Client mit, statt zur Laufzeit vom SDK abzuhängen, sodass die Installation klein und der Start sofort ist.

02

Installation

Trag ihn in die Serverkonfiguration eines beliebigen MCP-Clients ein. Der Server übernimmt die Authentifizierung selbst: Beim ersten Aufruf ohne Schlüssel liefert er eine Geräte-Login-URL, die du im Browser bestätigst.

{
  "mcpServers": {
    "capydb": {
      "command": "npx",
      "args": ["-y", "@capydb/mcp"],
      "env": { "CAPYDB_API_KEY": "capy_live_..." }
    }
  }
}

03

Clients

  • -Claude Code und die Claude-Desktop-App
  • -Cursor, Windsurf und andere Editoren mit MCP-Unterstützung
  • -Jeder Client, der das Model Context Protocol über stdio implementiert - der Server bedient die aktuelle und die frühere Protokollfassung
  • -Dein eigener Agent, über ein beliebiges MCP-SDK

04

Was die Werkzeuge abdecken

  • -Projekte: auflisten, anlegen, ansehen, umbenennen, pausieren, fortsetzen, löschen
  • -Verbindungen: direkte und gepoolte Connection Strings holen, Zugangsdaten rotieren
  • -SQL: Abfragen und Anweisungen gegen ein Projekt ausführen, mit Ergebnissen als strukturiertes JSON
  • -Schema: Tabellen, Spalten, Indizes und Extensions inspizieren
  • -Previews: Preview-Datenbanken anlegen, auflisten, zurücksetzen und löschen
  • -Backups: Backups auflisten, Wiederherstellungspunkte setzen, eine Preview auf einen Zeitpunkt zurückspielen
  • -Importe: einen Import von einem anderen Anbieter starten und verfolgen
  • -Workspace: Organisationen, Mitglieder, API-Schlüssel, Nutzung und Prüfeinträge

05

Sicherheit

Lesende Werkzeuge weisen sich als lesend aus, destruktive als destruktiv, sodass ein Client sie absichern kann. Destruktives SQL verlangt vorher einen Wiederherstellungspunkt - der Server weist den Agenten darauf hin, statt die Anweisung auszuführen.

Das Überschreiben einer Produktionsdatenbank per Wiederherstellung ist bewusst nicht als Werkzeug freigegeben. Ein Agent kann in eine Preview wiederherstellen, die du dann selbst übernimmst; deine Produktionsdaten kann er nicht von sich aus überschreiben.

06

Diagnose

Alles, was der Server über sich selbst sagt, geht auf die Standardfehlerausgabe, weil die Standardausgabe der Protokollkanal ist. Zeigt ein Client eine leere Werkzeugliste, liegt die Antwort fast immer im MCP-Log des Clients und nicht im Server.