Drizzle Sentinel MCP
🛡️ Drizzle Sentinel MCP
Servidor MCP de TypeScript de nivel de producción para inspección de esquemas de Drizzle ORM, linting de seguridad de migraciones y detección de desviación de esquemas.
🌟 Resumen y propósito
Los agentes de codificación autónomos (Claude Code, Cursor, Codex) suelen alucinar o generar migraciones de base de datos inseguras, como añadir columnas NOT NULL sin valores predeterminados, eliminar columnas activas u olvidar índices en claves foráneas.
Drizzle Sentinel MCP está diseñado para stacks de ingeniería TypeScript modernos (Turborepo + Drizzle ORM + Express / Next.js). Inyecta gobernanza de bases de datos de bucle cerrado directamente en los flujos de trabajo de desarrollo agénticos a través del Model Context Protocol oficial.
Related MCP server: Drizzle MCP Server
🏗️ Arquitectura del sistema
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)]🛠️ Herramientas MCP incluidas
inspect_drizzle_schema: Analiza en profundidad los esquemas Drizzle de TypeScript, mapea tablas y relaciones e identifica claves foráneas sin cobertura de índice.lint_drizzle_migration: Evalúa las sentencias SQL de migración según las reglas de seguridad de producción:NO_RAW_DROP_TABLE: Bloquea los borrados destructivos de tablas.NO_RAW_DROP_COLUMN: Exige migraciones de tipo expand-contract.REQUIRE_DEFAULT_ON_NOT_NULL: Evita fallos de migración y bloqueos de tabla en tablas existentes.NO_UNINDEXED_FOREIGN_KEYS: Advierte sobre la falta de cobertura de índice en las claves foráneas.
detect_schema_drift: Compara el esquema TypeScript declarado con las tablas reales de la base de datos, identifica con precisión las columnas/tablas ausentes y emite SQL de remediación no disruptivo con cero tiempo de inactividad.explain_query_plan: Aplica un sandbox de ejecución estricto de solo lectura y marca malos olores de rendimiento (MISSING_LIMIT,WILDCARD_PROJECTION,SORT_MEMORY_RISK).
📁 Estructura del repositorio
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🚀 Inicio rápido y configuración
1. Instalar dependencias y compilar
npm install
npm run build2. Ejecutar la suite de pruebas
npm test3. Registrar el servidor en la configuración MCP de Claude Code / Cursor
Añade el servidor a tu claude_desktop_config.json o a .cursor/mcp.json:
{
"mcpServers": {
"drizzle-sentinel": {
"command": "node",
"args": ["<path-to-repo>/packages/mcp-server/dist/index.js"]
}
}
}Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Deterministic safety, correctness & cost gate that vets Postgres SQL before your AI agent runs it.
SQL validation, formatting, parsing, metadata extraction, linting, and security analysis.
Review your AI agent's database changes on your schema, with plain-language risk, before they run.
Detects database migration table locks, terraform cost leaks, and OWASP API flaws.
Related MCP Servers
- AlicenseAqualityDmaintenanceAnalyzes database migrations for risks like lock contention and data loss before they run. Supports Flyway and Liquibase formats, providing risk scores and rollback generation.694 npmMIT
- AlicenseBqualityDmaintenanceProvides database schema management, query execution, and schema introspection through Drizzle ORM and drizzle-kit CLI tools, supporting SQLite and PostgreSQL.5474 npm16MIT
- AlicenseNot gradedqualityBmaintenanceGives AI coding assistants, IDEs, and CI full PostgreSQL schema intelligence from an offline snapshot, enabling linting, query validation, migration safety analysis, and foreign key graph exploration without ever exposing database credentials.36BSD 2-Clause "Simplified"
- AlicenseNot gradedqualityBmaintenanceExposes read-only tools that let AI assistants detect schema drift, analyze lock impact, verify data with checksums, and plan safe PostgreSQL migrations that are validated by deterministic checks and shadow runs.52 npmApache 2.0