schema-navigator-mcp 0.2.0

package/dist/tools/overview.js.map

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

package/dist/tools/policies.d.ts

@@ -0,0 +1,29 @@
+interface PolicyInfo {
+    name: string;
+    command: string;
+    permissive: boolean;
+    roles: string[];
+    using: string | null;
+    with_check: string | null;
+}
+interface AccessMatrix {
+    [role: string]: {
+        select: boolean;
+        insert: boolean;
+        update: boolean;
+        delete: boolean;
+    };
+}
+interface PoliciesResult {
+    table: string;
+    schema: string;
+    rls_enabled: boolean | null;
+    force_rls: boolean | null;
+    policies: PolicyInfo[];
+    matrix: AccessMatrix;
+    note?: string;
+}
+export declare function schemaPolicies(tableName: string, schema: string): Promise<PoliciesResult | {
+    error: string;
+}>;
+export {};

package/dist/tools/policies.js

@@ -0,0 +1,96 @@
+import { readOnlyMultiQuery, getIsPostgres } from "../db/postgres.js";
+import { parsePgArray } from "../utils/pg-array.js";
+export async function schemaPolicies(tableName, schema) {
+    const isPg = getIsPostgres();
+    if (!isPg) {
+        return {
+            table: tableName,
+            schema,
+            rls_enabled: null,
+            force_rls: null,
+            policies: [],
+            matrix: {},
+            note: "RLS is PostgreSQL-specific. Not available on this database.",
+        };
+    }
+    const results = await readOnlyMultiQuery([
+        // Check existence + RLS status
+        {
+            sql: `
+        SELECT c.relrowsecurity AS rls_enabled, c.relforcerowsecurity AS force_rls
+        FROM pg_class c
+        JOIN pg_namespace n ON n.oid = c.relnamespace
+        WHERE n.nspname = $1 AND c.relname = $2 AND c.relkind IN ('r', 'p')
+      `,
+            params: [schema, tableName],
+        },
+        // Policies
+        {
+            sql: `
+        SELECT
+          pol.polname AS name,
+          CASE pol.polcmd
+            WHEN 'r' THEN 'SELECT'
+            WHEN 'a' THEN 'INSERT'
+            WHEN 'w' THEN 'UPDATE'
+            WHEN 'd' THEN 'DELETE'
+            WHEN '*' THEN 'ALL'
+          END AS command,
+          pol.polpermissive AS permissive,
+          CASE
+            WHEN pol.polroles = '{0}' THEN ARRAY['public']
+            ELSE ARRAY(SELECT rolname FROM pg_roles WHERE oid = ANY(pol.polroles))
+          END AS roles,
+          pg_get_expr(pol.polqual, pol.polrelid) AS using_expr,
+          pg_get_expr(pol.polwithcheck, pol.polrelid) AS with_check
+        FROM pg_policy pol
+        JOIN pg_class c ON c.oid = pol.polrelid
+        JOIN pg_namespace n ON n.oid = c.relnamespace
+        WHERE n.nspname = $1 AND c.relname = $2
+        ORDER BY pol.polname
+      `,
+            params: [schema, tableName],
+        },
+    ]);
+    if (results[0].rows.length === 0) {
+        return { error: `Table '${tableName}' not found in schema '${schema}'` };
+    }
+    const meta = results[0].rows[0];
+    const rlsEnabled = meta.rls_enabled;
+    const forceRls = meta.force_rls;
+    const policies = results[1].rows.map((r) => ({
+        name: r.name,
+        command: r.command,
+        permissive: r.permissive,
+        roles: parsePgArray(r.roles),
+        using: r.using_expr ?? null,
+        with_check: r.with_check ?? null,
+    }));
+    // Build access matrix
+    const matrix = {};
+    for (const policy of policies) {
+        for (const role of policy.roles) {
+            if (!matrix[role]) {
+                matrix[role] = { select: false, insert: false, update: false, delete: false };
+            }
+            const cmd = policy.command;
+            if (cmd === "ALL" || cmd === "SELECT")
+                matrix[role].select = true;
+            if (cmd === "ALL" || cmd === "INSERT")
+                matrix[role].insert = true;
+            if (cmd === "ALL" || cmd === "UPDATE")
+                matrix[role].update = true;
+            if (cmd === "ALL" || cmd === "DELETE")
+                matrix[role].delete = true;
+        }
+    }
+    return {
+        table: tableName,
+        schema,
+        rls_enabled: rlsEnabled,
+        force_rls: forceRls,
+        policies,
+        matrix,
+    };
+}
+//# sourceMappingURL=policies.js.map

package/dist/tools/policies.js.map

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

package/dist/tools/relations.d.ts

@@ -0,0 +1,18 @@
+interface FKRelation {
+    constraint_name: string;
+    column: string;
+    foreign_table: string;
+    foreign_column: string;
+    on_delete: string;
+    on_update: string;
+}
+interface RelationsResult {
+    table: string;
+    schema: string;
+    outbound: FKRelation[];
+    inbound: FKRelation[];
+}
+export declare function schemaRelations(tableName: string, schema: string): Promise<RelationsResult | {
+    error: string;
+}>;
+export {};

package/dist/tools/relations.js

@@ -0,0 +1,72 @@
+import { readOnlyMultiQuery } from "../db/postgres.js";
+export async function schemaRelations(tableName, schema) {
+    // Check existence first
+    const results = await readOnlyMultiQuery([
+        {
+            sql: `SELECT 1 FROM information_schema.tables WHERE table_schema = $1 AND table_name = $2`,
+            params: [schema, tableName],
+        },
+        // Outbound FKs (this table references others)
+        {
+            sql: `
+        SELECT
+          tc.constraint_name,
+          kcu.column_name AS column,
+          ccu.table_name AS foreign_table,
+          ccu.column_name AS foreign_column,
+          rc.delete_rule AS on_delete,
+          rc.update_rule AS on_update
+        FROM information_schema.table_constraints tc
+        JOIN information_schema.key_column_usage kcu
+          ON kcu.constraint_name = tc.constraint_name AND kcu.constraint_schema = tc.constraint_schema
+        JOIN information_schema.constraint_column_usage ccu
+          ON ccu.constraint_name = tc.constraint_name AND ccu.constraint_schema = tc.constraint_schema
+        JOIN information_schema.referential_constraints rc
+          ON rc.constraint_name = tc.constraint_name AND rc.constraint_schema = tc.constraint_schema
+        WHERE tc.table_schema = $1 AND tc.table_name = $2 AND tc.constraint_type = 'FOREIGN KEY'
+        ORDER BY tc.constraint_name
+      `,
+            params: [schema, tableName],
+        },
+        // Inbound FKs (others reference this table)
+        {
+            sql: `
+        SELECT
+          tc.constraint_name,
+          ccu.column_name AS column,
+          kcu.table_name AS foreign_table,
+          kcu.column_name AS foreign_column,
+          rc.delete_rule AS on_delete,
+          rc.update_rule AS on_update
+        FROM information_schema.table_constraints tc
+        JOIN information_schema.key_column_usage kcu
+          ON kcu.constraint_name = tc.constraint_name AND kcu.constraint_schema = tc.constraint_schema
+        JOIN information_schema.constraint_column_usage ccu
+          ON ccu.constraint_name = tc.constraint_name AND ccu.constraint_schema = tc.constraint_schema
+        JOIN information_schema.referential_constraints rc
+          ON rc.constraint_name = tc.constraint_name AND rc.constraint_schema = tc.constraint_schema
+        WHERE ccu.table_schema = $1 AND ccu.table_name = $2 AND tc.constraint_type = 'FOREIGN KEY'
+        ORDER BY tc.constraint_name
+      `,
+            params: [schema, tableName],
+        },
+    ]);
+    if (results[0].rows.length === 0) {
+        return { error: `Table '${tableName}' not found in schema '${schema}'` };
+    }
+    const mapRow = (r) => ({
+        constraint_name: r.constraint_name,
+        column: r.column,
+        foreign_table: r.foreign_table,
+        foreign_column: r.foreign_column,
+        on_delete: r.on_delete,
+        on_update: r.on_update,
+    });
+    return {
+        table: tableName,
+        schema,
+        outbound: results[1].rows.map(mapRow),
+        inbound: results[2].rows.map(mapRow),
+    };
+}
+//# sourceMappingURL=relations.js.map

package/dist/tools/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/tools/relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAkBvD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,MAAc;IAEd,wBAAwB;IACxB,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC;QACvC;YACE,GAAG,EAAE,qFAAqF;YAC1F,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC5B;QACD,8CAA8C;QAC9C;YACE,GAAG,EAAE;;;;;;;;;;;;;;;;;OAiBJ;YACD,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC5B;QACD,4CAA4C;QAC5C;YACE,GAAG,EAAE;;;;;;;;;;;;;;;;;OAiBJ;YACD,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;SAC5B;KACF,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,UAAU,SAAS,0BAA0B,MAAM,GAAG,EAAE,CAAC;IAC3E,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAA0B,EAAc,EAAE,CAAC,CAAC;QAC1D,eAAe,EAAE,CAAC,CAAC,eAAyB;QAC5C,MAAM,EAAE,CAAC,CAAC,MAAgB;QAC1B,aAAa,EAAE,CAAC,CAAC,aAAuB;QACxC,cAAc,EAAE,CAAC,CAAC,cAAwB;QAC1C,SAAS,EAAE,CAAC,CAAC,SAAmB;QAChC,SAAS,EAAE,CAAC,CAAC,SAAmB;KACjC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,MAAM;QACN,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;QACrC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,13 @@
+interface SearchMatch {
+    type: string;
+    name: string;
+    context: string;
+}
+interface SearchResult {
+    term: string;
+    schema: string;
+    matches: SearchMatch[];
+    truncated: boolean;
+}
+export declare function schemaFind(term: string, schema: string): Promise<SearchResult>;
+export {};

package/dist/tools/search.js

@@ -0,0 +1,77 @@
+import { readOnlyQuery, getIsPostgres } from "../db/postgres.js";
+const MAX_RESULTS = 50;
+export async function schemaFind(term, schema) {
+    const isPg = getIsPostgres();
+    // Escape ILIKE special characters so % and _ are treated as literals
+    const escaped = term.replace(/[%_\\]/g, "\\$&");
+    const pattern = `%${escaped}%`;
+    // Build UNION ALL search across object types
+    const parts = [];
+    const params = [schema, pattern];
+    // Tables
+    parts.push(`
+    SELECT 'table' AS type, table_name AS name, table_type AS context
+    FROM information_schema.tables
+    WHERE table_schema = $1 AND table_name ILIKE $2
+  `);
+    // Columns
+    parts.push(`
+    SELECT 'column' AS type, column_name AS name, table_name || '.' || column_name || ' (' || data_type || ')' AS context
+    FROM information_schema.columns
+    WHERE table_schema = $1 AND column_name ILIKE $2
+  `);
+    // Functions
+    parts.push(`
+    SELECT 'function' AS type, routine_name AS name, routine_type || ' → ' || COALESCE(data_type, 'void') AS context
+    FROM information_schema.routines
+    WHERE routine_schema = $1 AND routine_name ILIKE $2
+  `);
+    // Views
+    parts.push(`
+    SELECT 'view' AS type, table_name AS name, 'view' AS context
+    FROM information_schema.views
+    WHERE table_schema = $1 AND table_name ILIKE $2
+  `);
+    if (isPg) {
+        // Materialized views
+        parts.push(`
+      SELECT 'materialized_view' AS type, matviewname AS name, 'materialized view' AS context
+      FROM pg_matviews
+      WHERE schemaname = $1 AND matviewname ILIKE $2
+    `);
+        // RLS Policies
+        parts.push(`
+      SELECT 'policy' AS type, policyname AS name, 'on ' || tablename || ' (' || cmd || ')' AS context
+      FROM pg_policies
+      WHERE schemaname = $1 AND policyname ILIKE $2
+    `);
+        // ENUMs
+        parts.push(`
+      SELECT 'enum' AS type, t.typname AS name, 'enum type' AS context
+      FROM pg_type t
+      JOIN pg_namespace n ON n.oid = t.typnamespace
+      WHERE n.nspname = $1 AND t.typname ILIKE $2 AND t.typtype = 'e'
+    `);
+        // Column comments
+        parts.push(`
+      SELECT 'comment' AS type, a.attname AS name,
+        c.relname || '.' || a.attname || ': ' || d.description AS context
+      FROM pg_description d
+      JOIN pg_class c ON c.oid = d.objoid
+      JOIN pg_namespace n ON n.oid = c.relnamespace
+      JOIN pg_attribute a ON a.attrelid = c.oid AND a.attnum = d.objsubid
+      WHERE n.nspname = $1 AND d.description ILIKE $2 AND d.objsubid > 0
+    `);
+    }
+    const sql = parts.join("\nUNION ALL\n") + "\nLIMIT $3";
+    params.push(MAX_RESULTS + 1);
+    const result = await readOnlyQuery(sql, params);
+    const truncated = result.rows.length > MAX_RESULTS;
+    const matches = result.rows.slice(0, MAX_RESULTS).map((r) => ({
+        type: r.type,
+        name: r.name,
+        context: r.context,
+    }));
+    return { term, schema, matches, truncated };
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAejE,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,MAAc;IAEd,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,qEAAqE;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC;IAE/B,6CAA6C;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5C,SAAS;IACT,KAAK,CAAC,IAAI,CAAC;;;;GAIV,CAAC,CAAC;IAEH,UAAU;IACV,KAAK,CAAC,IAAI,CAAC;;;;GAIV,CAAC,CAAC;IAEH,YAAY;IACZ,KAAK,CAAC,IAAI,CAAC;;;;GAIV,CAAC,CAAC;IAEH,QAAQ;IACR,KAAK,CAAC,IAAI,CAAC;;;;GAIV,CAAC,CAAC;IAEH,IAAI,IAAI,EAAE,CAAC;QACT,qBAAqB;QACrB,KAAK,CAAC,IAAI,CAAC;;;;KAIV,CAAC,CAAC;QAEH,eAAe;QACf,KAAK,CAAC,IAAI,CAAC;;;;KAIV,CAAC,CAAC;QAEH,QAAQ;QACR,KAAK,CAAC,IAAI,CAAC;;;;;KAKV,CAAC,CAAC;QAEH,kBAAkB;QAClB,KAAK,CAAC,IAAI,CAAC;;;;;;;;KAQV,CAAC,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;IACvD,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEhD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;IACnD,MAAM,OAAO,GAAkB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,IAAI,EAAE,CAAC,CAAC,IAAc;QACtB,IAAI,EAAE,CAAC,CAAC,IAAc;QACtB,OAAO,EAAE,CAAC,CAAC,OAAiB;KAC7B,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC9C,CAAC"}

package/dist/tools/table-profile.d.ts

@@ -0,0 +1,68 @@
+interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable: boolean;
+    default: string | null;
+    comment: string | null;
+}
+interface ConstraintInfo {
+    name: string;
+    type: string;
+    columns: string[];
+    definition?: string;
+    allowed_values?: string[];
+}
+interface ForeignKey {
+    constraint_name: string;
+    column: string;
+    foreign_table: string;
+    foreign_column: string;
+    on_delete: string;
+    on_update: string;
+}
+interface IndexInfo {
+    name: string;
+    columns: string;
+    unique: boolean;
+    definition: string;
+}
+interface TriggerInfo {
+    name: string;
+    event: string;
+    timing: string;
+    function: string;
+}
+interface PolicyInfo {
+    name: string;
+    command: string;
+    roles: string[];
+    using: string | null;
+    with_check: string | null;
+}
+interface GrantInfo {
+    grantee: string;
+    privileges: string[];
+}
+interface TableProfileResult {
+    object_type: string;
+    schema: string;
+    name: string;
+    columns: ColumnInfo[];
+    constraints: ConstraintInfo[];
+    fks_out: ForeignKey[];
+    fks_in: ForeignKey[];
+    indexes: IndexInfo[];
+    triggers: TriggerInfo[];
+    policies: PolicyInfo[];
+    rls_enabled: boolean | null;
+    grants: GrantInfo[];
+    size: string | null;
+    row_count: number | null;
+    view_definition?: string;
+    is_updatable?: boolean;
+    is_populated?: boolean;
+}
+export declare function schemaTable(tableName: string, schema: string): Promise<TableProfileResult | {
+    error: string;
+}>;
+export {};