devvault-mcp

Ein kleiner MCP-Server, der Claude Code strukturierten Zugriff auf die lokale Postgres-Datenbank von DevVault bietet – Schema inspizieren, schreibgeschützte Abfragen ausführen, abgesicherte Schreibvorgänge durchführen und Dummy-Daten für Tests erzeugen.

Verbindung

DATABASE_URL wird in dieser Reihenfolge aufgelöst:

1. process.env.DATABASE_URL

2. DEVVAULT_ENV_PATH (Pfad zu einer .env-Datei), falls gesetzt

3. ../devvault-backend/.env

So bleibt das DB-Passwort in der .env des Backends und wird nicht in eine MCP-Konfiguration dupliziert.

Related MCP server: PostgreSQL MCP Server

Tools

Sicherheitsvorkehrungen

• run_query lehnt alles ab, was nicht schreibgeschützt ist, und blockiert das Stapeln von Anweisungen (;).

• run_write verweigert DROP/TRUNCATE/ALTER/CREATE/GRANT/… sowie UPDATE/DELETE ohne WHERE-Klausel, es sei denn, Sie übergeben allowDangerous: true.

• Schreibvorgänge werden in einer Transaktion ausgeführt und bei einem Fehler zurückgerollt.

Registrierung bei Claude Code

Bereits über ../.mcp.json (Projektbereich) eingerichtet:

{
  "mcpServers": {
    "devvault-db": {
      "command": "node",
      "args": ["/Users/cookie/project-git/devvault_2/devvault-mcp/server.js"]
    }
  }
}

MCP-Server werden beim Start von Claude Code geladen. Starten Sie die Sitzung daher neu bzw. verbinden Sie sie neu, damit die devvault-db-Tools erscheinen.

Lokale Prüfungen (kein MCP-Client erforderlich)

npm install
node smoke.js     # connectivity + row counts
node mcptest.js   # full MCP handshake: list tools + call a few

Dummy-Daten

Seed-Zeilen, die von seed_dummy erstellt wurden, haben alle Titel, die mit Dummy beginnen. Um sie zu entfernen:

DELETE FROM prompts  WHERE title LIKE 'Dummy %';
DELETE FROM commands WHERE title LIKE 'Dummy %';
DELETE FROM snippets WHERE title LIKE 'Dummy %';
DELETE FROM bookmarks WHERE title LIKE 'Dummy %';
DELETE FROM notes    WHERE title LIKE 'Dummy %';