locksmith-mcp 0.1.0

package/dist/data/lockMatrix.js

@@ -0,0 +1,65 @@
+export const LOCK_MODES = [
+    {
+        mode: "ACCESS SHARE",
+        blocks: "Only conflicts with ACCESS EXCLUSIVE. Taken by plain SELECT.",
+        acquiredBy: ["SELECT"],
+    },
+    {
+        mode: "ROW SHARE",
+        blocks: "Conflicts with EXCLUSIVE and ACCESS EXCLUSIVE.",
+        acquiredBy: ["SELECT ... FOR UPDATE / FOR SHARE"],
+    },
+    {
+        mode: "ROW EXCLUSIVE",
+        blocks: "Conflicts with SHARE and above. Normal writes take this.",
+        acquiredBy: ["INSERT", "UPDATE", "DELETE"],
+    },
+    {
+        mode: "SHARE UPDATE EXCLUSIVE",
+        blocks: "Blocks schema changes and VACUUM, but NOT reads or writes.",
+        acquiredBy: ["CREATE INDEX CONCURRENTLY", "VALIDATE CONSTRAINT", "ALTER TABLE ... ADD ... NOT VALID"],
+    },
+    {
+        mode: "SHARE",
+        blocks: "Blocks all writes (INSERT/UPDATE/DELETE); reads still allowed.",
+        acquiredBy: ["CREATE INDEX (non-concurrent)"],
+    },
+    {
+        mode: "SHARE ROW EXCLUSIVE",
+        blocks: "Blocks writes and other schema changes on the table(s).",
+        acquiredBy: ["ALTER TABLE ... ADD FOREIGN KEY (validating, both tables)"],
+    },
+    {
+        mode: "EXCLUSIVE",
+        blocks: "Blocks reads-for-update and all writes; plain SELECT still allowed.",
+        acquiredBy: ["REFRESH MATERIALIZED VIEW CONCURRENTLY"],
+    },
+    {
+        mode: "ACCESS EXCLUSIVE",
+        blocks: "Blocks EVERYTHING, including plain SELECT. The most disruptive lock.",
+        acquiredBy: [
+            "ALTER TABLE ... ALTER COLUMN ... TYPE",
+            "ALTER TABLE ... SET NOT NULL",
+            "ALTER TABLE ... ADD CHECK (validating)",
+            "DROP TABLE / DROP COLUMN",
+            "TRUNCATE",
+        ],
+    },
+];
+export function renderLockMatrix() {
+    const lines = [
+        "# PostgreSQL Table-Level Locks",
+        "",
+        "What each lock blocks, and the operations that take it. ACCESS EXCLUSIVE is",
+        "the one to fear: it blocks even plain SELECTs.",
+        "",
+    ];
+    for (const m of LOCK_MODES) {
+        lines.push(`## ${m.mode}`);
+        lines.push(`- Blocks: ${m.blocks}`);
+        lines.push(`- Acquired by: ${m.acquiredBy.join("; ")}`);
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=lockMatrix.js.map

package/dist/data/lockMatrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockMatrix.js","sourceRoot":"","sources":["../../src/data/lockMatrix.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,UAAU,GAAe;IACpC;QACE,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,8DAA8D;QACtE,UAAU,EAAE,CAAC,QAAQ,CAAC;KACvB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,gDAAgD;QACxD,UAAU,EAAE,CAAC,mCAAmC,CAAC;KAClD;IACD;QACE,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,0DAA0D;QAClE,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;KAC3C;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,4DAA4D;QACpE,UAAU,EAAE,CAAC,2BAA2B,EAAE,qBAAqB,EAAE,mCAAmC,CAAC;KACtG;IACD;QACE,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,gEAAgE;QACxE,UAAU,EAAE,CAAC,+BAA+B,CAAC;KAC9C;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,yDAAyD;QACjE,UAAU,EAAE,CAAC,2DAA2D,CAAC;KAC1E;IACD;QACE,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,qEAAqE;QAC7E,UAAU,EAAE,CAAC,wCAAwC,CAAC;KACvD;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,sEAAsE;QAC9E,UAAU,EAAE;YACV,uCAAuC;YACvC,8BAA8B;YAC9B,wCAAwC;YACxC,0BAA0B;YAC1B,UAAU;SACX;KACF;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG;QACZ,gCAAgC;QAChC,EAAE;QACF,6EAA6E;QAC7E,gDAAgD;QAChD,EAAE;KACH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisResult } from "./analyzer/types.js";
+/** Render an analysis result as Markdown for human (and model) consumption. */
+export declare function renderReport(result: AnalysisResult): string;

package/dist/format.js

@@ -0,0 +1,52 @@
+const ICON = { critical: "🛑", warning: "⚠️", info: "ℹ️" };
+const VERDICT_LINE = {
+    BLOCK: "🛑 BLOCK — do not ship as written",
+    REVIEW: "⚠️ REVIEW — confirm this is safe for your tables",
+    PASS: "✅ PASS — no locking hazards detected",
+};
+/** Render an analysis result as Markdown for human (and model) consumption. */
+export function renderReport(result) {
+    const lines = [];
+    lines.push(`# Locksmith — Migration Safety Report`);
+    lines.push("");
+    lines.push(`**Verdict: ${VERDICT_LINE[result.verdict]}**`);
+    lines.push("");
+    lines.push(result.summary);
+    lines.push("");
+    lines.push(`_Analyzed ${result.stats.statements} statement(s); ` +
+        `${result.stats.critical} critical, ${result.stats.warning} warning, ` +
+        `${result.stats.suppressed} suppressed, ${result.stats.unparsed} unparsed._`);
+    if (result.findings.length === 0) {
+        return lines.join("\n");
+    }
+    lines.push("");
+    lines.push("---");
+    for (const f of result.findings) {
+        lines.push("");
+        lines.push(renderFinding(f));
+    }
+    return lines.join("\n");
+}
+function renderFinding(f) {
+    const out = [];
+    out.push(`## ${ICON[f.severity]} ${f.title}  \`${f.ruleId}\` (line ${f.line})`);
+    out.push("");
+    out.push(`> \`${f.statement}\``);
+    out.push("");
+    out.push(`**Problem:** ${f.message}`);
+    if (f.lockTaken)
+        out.push(`**Lock taken:** ${f.lockTaken}`);
+    out.push(`**Why it matters:** ${f.rationale}`);
+    out.push(`**Fix:** ${f.remediation}`);
+    if (f.suggestedRewrite) {
+        out.push("");
+        out.push("**Suggested rewrite:**");
+        out.push("```sql");
+        out.push(f.suggestedRewrite);
+        out.push("```");
+    }
+    if (f.docsUrl)
+        out.push(`📖 ${f.docsUrl}`);
+    return out.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+/**
+ * Entry point: run Locksmith as a stdio MCP server. An MCP client (Claude
+ * Desktop/Code, the MCP Inspector, etc.) launches this process and speaks
+ * JSON-RPC over stdin/stdout — so nothing may be written to stdout except the
+ * protocol. All diagnostics go to stderr.
+ */
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write("locksmith MCP server running on stdio\n");
+}
+main().catch((err) => {
+    process.stderr.write(`locksmith failed to start: ${String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAClE,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Build and configure the Locksmith MCP server (transport-agnostic). */
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,128 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { analyzeMigration } from "./analyzer/engine.js";
+import { rules } from "./analyzer/rules/index.js";
+import { LOCK_MODES, renderLockMatrix } from "./data/lockMatrix.js";
+import { renderReport } from "./format.js";
+const findingSchema = z.object({
+    ruleId: z.string(),
+    title: z.string(),
+    severity: z.enum(["info", "warning", "critical"]),
+    line: z.number(),
+    statement: z.string(),
+    lockTaken: z.string().optional(),
+    message: z.string(),
+    rationale: z.string(),
+    remediation: z.string(),
+    suggestedRewrite: z.string().optional(),
+    docsUrl: z.string().optional(),
+});
+const analysisOutputSchema = {
+    verdict: z.enum(["PASS", "REVIEW", "BLOCK"]),
+    summary: z.string(),
+    stats: z.object({
+        statements: z.number(),
+        findings: z.number(),
+        critical: z.number(),
+        warning: z.number(),
+        info: z.number(),
+        suppressed: z.number(),
+        unparsed: z.number(),
+    }),
+    findings: z.array(findingSchema),
+};
+/** Build and configure the Locksmith MCP server (transport-agnostic). */
+export function createServer() {
+    const server = new McpServer({ name: "locksmith", version: "0.1.0" });
+    // --- Tool: analyze_migration -------------------------------------------
+    server.registerTool("analyze_migration", {
+        title: "Analyze a SQL migration for locking hazards",
+        description: "Lint a PostgreSQL migration for operations that take dangerous locks (table rewrites, " +
+            "blocking index builds, validating constraints, destructive/breaking changes) and return " +
+            "a PASS/REVIEW/BLOCK verdict with per-statement findings and safe rewrites. " +
+            "Call this before applying or approving any migration.",
+        inputSchema: {
+            sql: z.string().describe("The full SQL migration script to analyze."),
+            assumeLargeTables: z
+                .boolean()
+                .optional()
+                .describe("Assume target tables are large/hot, so scans and rewrites are flagged. Default true (fail safe)."),
+        },
+        outputSchema: analysisOutputSchema,
+    }, async ({ sql, assumeLargeTables }) => {
+        const result = analyzeMigration(sql, { assumeLargeTables });
+        return {
+            content: [{ type: "text", text: renderReport(result) }],
+            structuredContent: result,
+        };
+    });
+    // --- Tool: explain_lock ------------------------------------------------
+    server.registerTool("explain_lock", {
+        title: "Explain a PostgreSQL lock mode",
+        description: "Given a lock mode name (e.g. 'ACCESS EXCLUSIVE') or a fragment of an operation, explain " +
+            "what it blocks and which operations acquire it.",
+        inputSchema: {
+            query: z.string().describe("A lock mode name or operation fragment, e.g. 'ACCESS EXCLUSIVE' or 'create index'."),
+        },
+    }, async ({ query }) => {
+        const q = query.toLowerCase();
+        const matches = LOCK_MODES.filter((m) => m.mode.toLowerCase().includes(q) ||
+            m.acquiredBy.some((op) => op.toLowerCase().includes(q) || q.includes(op.toLowerCase())));
+        const chosen = matches.length > 0 ? matches : LOCK_MODES;
+        const text = chosen
+            .map((m) => `### ${m.mode}\n- Blocks: ${m.blocks}\n- Acquired by: ${m.acquiredBy.join("; ")}`)
+            .join("\n\n");
+        return { content: [{ type: "text", text }] };
+    });
+    // --- Resource: the Postgres lock matrix --------------------------------
+    server.registerResource("lock-matrix", "locksmith://lock-matrix", {
+        title: "PostgreSQL lock compatibility matrix",
+        description: "Which lock each operation takes and what that lock blocks.",
+        mimeType: "text/markdown",
+    }, async (uri) => ({
+        contents: [{ uri: uri.href, mimeType: "text/markdown", text: renderLockMatrix() }],
+    }));
+    // --- Resource: the rule catalog ----------------------------------------
+    server.registerResource("rules", "locksmith://rules", {
+        title: "Locksmith rule catalog",
+        description: "All migration-safety rules, their severity, and rationale.",
+        mimeType: "application/json",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify(rules.map((r) => ({
+                    id: r.id,
+                    title: r.title,
+                    severity: r.severity,
+                    rationale: r.rationale,
+                    remediation: r.remediation,
+                    docsUrl: r.docsUrl,
+                })), null, 2),
+            },
+        ],
+    }));
+    // --- Prompt: review-migration ------------------------------------------
+    server.registerPrompt("review-migration", {
+        title: "Review a migration for safety",
+        description: "Analyze a migration with Locksmith and summarize the risk for a PR comment.",
+        argsSchema: { sql: z.string().describe("The migration SQL to review.") },
+    }, ({ sql }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Call the `analyze_migration` tool on the SQL below. Then write a concise PR review " +
+                        "comment: state the verdict, list each blocking/risky operation with its safe rewrite, " +
+                        "and end with a clear ship / don't-ship recommendation.\n\n```sql\n" +
+                        sql +
+                        "\n```",
+                },
+            },
+        ],
+    }));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "locksmith-mcp",
+  "version": "0.1.0",
+  "description": "Locksmith — an MCP server that lints SQL migrations for dangerous locking operations and suggests safe rewrites (PostgreSQL).",
+  "type": "module",
+  "license": "MIT",
+  "author": "Christopher King <chris@cking.me>",
+  "homepage": "https://github.com/cxk280/locksmith#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cxk280/locksmith.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cxk280/locksmith/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "postgres",
+    "postgresql",
+    "migration",
+    "database",
+    "lint",
+    "safety",
+    "ddl",
+    "locks"
+  ],
+  "bin": {
+    "locksmith": "dist/index.js",
+    "locksmith-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "inspect": "npm run build && npx @modelcontextprotocol/inspector node dist/index.js",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "pgsql-ast-parser": "^12.0.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}