🛡️ Drizzle Sentinel MCP

Produktionsreifer TypeScript-MCP-Server für Drizzle-ORM-Schema-Inspektion, Migrations-Sicherheits-Linting und Schema-Drift-Erkennung.

🌟 Überblick & Zweck

Autonome Coding-Agenten (Claude Code, Cursor, Codex) halluzinieren häufig oder generieren unsichere Datenbankmigrationen – etwa das Hinzufügen von NOT NULL-Spalten ohne Standardwerte, das Entfernen aktiver Spalten oder das Vergessen von Indizes auf Fremdschlüsseln.

Drizzle Sentinel MCP wurde für moderne TypeScript-Engineering-Stacks (Turborepo + Drizzle ORM + Express / Next.js) entwickelt. Es integriert eine geschlossene Datenbank-Governance-Schleife direkt in agentische Entwicklungsworkflows über das offizielle Model Context Protocol.

Related MCP server: schema-lint-mcp

🏗️ Systemarchitektur

graph TD
  Agent[Agentic IDE / Claude Code / Cursor] -->|MCP Protocol / stdio| Sentinel[🛡️ Drizzle Sentinel MCP Server]
  
  subgraph Tools [MCP Governance Toolsuite]
    Sentinel --> T1[🔍 inspect_drizzle_schema]
    Sentinel --> T2[🚨 lint_drizzle_migration]
    Sentinel --> T3[🩺 detect_schema_drift]
    Sentinel --> T4[⚡ explain_query_plan]
  end

  T1 --> Parser[Drizzle Schema AST Parser]
  T2 --> Engine[Rules Engine: NO_DROP, DEFAULT_ON_NOT_NULL, UNINDEXED_FK]
  T3 --> Drift[Drift Doctor & Safe Patch Generator]
  T4 --> Sandbox[Read-Only Query Sandbox & Smell Detector]

  Parser --> AppCode[TypeScript Drizzle Schemas]
  Engine --> Migrations[Drizzle Migration .sql Files]
  Drift --> Database[(PostgreSQL / SQLite / MySQL)]

🛠️ Bereitgestellte MCP-Tools

1. inspect_drizzle_schema: Analysiert TypeScript-Drizzle-Schemas eingehend, bildet Tabellen und Beziehungen ab und identifiziert Fremdschlüssel ohne Indexabdeckung.

2. lint_drizzle_migration: Bewertet SQL-Migrationsanweisungen anhand von Produktionssicherheitsregeln:

   • NO_RAW_DROP_TABLE: Blockiert destruktive Tabellenlöschungen.

   • NO_RAW_DROP_COLUMN: Erzwingt Expand-Contract-Migrationen.

   • REQUIRE_DEFAULT_ON_NOT_NULL: Verhindert Migrationsfehler und Tabellensperren bei bestehenden Tabellen.

   • NO_UNINDEXED_FOREIGN_KEYS: Warnt bei fehlender FK-Indexabdeckung.

3. detect_schema_drift: Vergleicht das deklarierte TypeScript-Schema mit Live-Datenbanktabellen, lokalisiert fehlende Spalten/Tabellen und generiert nicht-brechendes Remediation-SQL ohne Ausfallzeiten.

4. explain_query_plan: Erzwingt eine strikte Read-only-Ausführungssandbox und kennzeichnet Performance-Probleme (MISSING_LIMIT, WILDCARD_PROJECTION, SORT_MEMORY_RISK).

📁 Repository-Struktur

drizzle-sentinel-mcp/
├── packages/
│   ├── mcp-server/       # TypeScript MCP server implementation
│   │   ├── src/tools/    # Tool handlers (inspect, lint, drift, sandbox)
│   │   ├── src/services/ # AST & schema parsers
│   │   └── src/index.ts  # Stdio server entrypoint
│   └── rules-engine/     # AST & regex defensive migration rules
├── apps/
│   └── demo-service/     # Express + Drizzle ORM reference application
├── tests/                # Vitest comprehensive unit & integration test suite
├── turbo.json            # Turborepo task pipeline
├── CLAUDE.md             # Agentic guidelines & operating rules
└── README.md

🚀 Schnellstart & Einrichtung

1. Abhängigkeiten installieren und Build ausführen

npm install
npm run build

2. Test-Suite ausführen

npm test

3. Bei Claude Code / Cursor MCP-Konfiguration registrieren

Fügen Sie den Server zu Ihrer claude_desktop_config.json oder .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "drizzle-sentinel": {
      "command": "node",
      "args": ["<path-to-repo>/packages/mcp-server/dist/index.js"]
    }
  }
}