lintbase-mcp 0.1.0

package/dist/tools/issues.tool.js.map

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

package/dist/tools/scan.tool.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerScanTool(server: McpServer): void;
+//# sourceMappingURL=scan.tool.d.ts.map

package/dist/tools/scan.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.tool.d.ts","sourceRoot":"","sources":["../../src/tools/scan.tool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmKpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8BxD"}

package/dist/tools/scan.tool.js

@@ -0,0 +1,207 @@
+"use strict";
+// packages/lintbase-mcp/src/tools/scan.tool.ts
+//
+// MCP Tool: lintbase_scan
+// Runs a full LintBase scan against a Firestore database and returns
+// the structured report (same shape as `lintbase scan --json`).
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerScanTool = registerScanTool;
+const zod_1 = require("zod");
+const admin = __importStar(require("firebase-admin"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const SchemaDrift = __importStar(require("../core/schema-drift.analyzer.js"));
+const Performance = __importStar(require("../core/performance.analyzer.js"));
+const Security = __importStar(require("../core/security.analyzer.js"));
+const Cost = __importStar(require("../core/cost.analyzer.js"));
+// ── Risk score (mirrored from CLI) ───────────────────────────────────────────
+function computeRiskScore(errors, warnings, infos) {
+    return Math.min(100, errors * 12 + warnings * 4 + infos * 1);
+}
+// ── Firestore type helpers ────────────────────────────────────────────────────
+function inferType(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (Array.isArray(value))
+        return 'array';
+    if (typeof value === 'object' && value !== null &&
+        'toDate' in value && typeof value.toDate === 'function')
+        return 'timestamp';
+    if (typeof value === 'object' && value !== null &&
+        'path' in value && 'id' in value)
+        return 'reference';
+    if (typeof value === 'object')
+        return 'map';
+    return typeof value;
+}
+function calculateDepth(obj, current = 1) {
+    if (typeof obj !== 'object' || obj === null || Array.isArray(obj))
+        return current;
+    const values = Object.values(obj);
+    if (values.length === 0)
+        return current;
+    return Math.max(...values.map((v) => calculateDepth(v, current + 1)));
+}
+function mapDocument(doc, collection) {
+    const rawData = doc.data();
+    const fields = {};
+    for (const [key, value] of Object.entries(rawData)) {
+        fields[key] = { value, type: inferType(value) };
+    }
+    const depth = calculateDepth(rawData);
+    const sizeBytes = (() => {
+        try {
+            return Buffer.byteLength(JSON.stringify(rawData), 'utf-8');
+        }
+        catch {
+            return 0;
+        }
+    })();
+    return { id: doc.id, collection, fields, depth, sizeBytes };
+}
+// ── Core scan function ────────────────────────────────────────────────────────
+async function runScan(keyPath, sampleSize, collections) {
+    const resolvedKey = path.resolve(keyPath);
+    if (!fs.existsSync(resolvedKey)) {
+        throw new Error(`Service account file not found: ${resolvedKey}`);
+    }
+    const serviceAccount = JSON.parse(fs.readFileSync(resolvedKey, 'utf-8'));
+    // Avoid re-initializing Firebase if already running
+    if (!admin.apps.length) {
+        admin.initializeApp({ credential: admin.credential.cert(serviceAccount) });
+    }
+    const db = admin.firestore();
+    // Discover collections
+    const allCollections = (await db.listCollections()).map((c) => c.id);
+    const targetCollections = collections && collections.length > 0
+        ? allCollections.filter((c) => collections.includes(c))
+        : allCollections;
+    if (targetCollections.length === 0) {
+        throw new Error(collections && collections.length > 0
+            ? `None of the requested collections [${collections.join(', ')}] were found. Available: [${allCollections.join(', ')}]`
+            : 'No collections found in this Firestore database.');
+    }
+    // Sample documents
+    const allDocuments = [];
+    for (const col of targetCollections) {
+        const snapshot = await db.collection(col).limit(sampleSize).get();
+        allDocuments.push(...snapshot.docs.map((doc) => mapDocument(doc, col)));
+    }
+    const scanResult = {
+        connector: 'firestore',
+        collections: targetCollections,
+        documentCount: allDocuments.length,
+        documents: allDocuments,
+        scannedAt: new Date(),
+    };
+    // Run all analyzers
+    const analysisOptions = { limit: sampleSize };
+    const [schemaDriftIssues, perfIssues, securityIssues, costIssues] = await Promise.all([
+        Promise.resolve(SchemaDrift.analyze(scanResult, analysisOptions)),
+        Promise.resolve(Performance.analyze(scanResult, analysisOptions)),
+        Promise.resolve(Security.analyze(scanResult, analysisOptions)),
+        Promise.resolve(Cost.analyze(scanResult, analysisOptions)),
+    ]);
+    const issues = [
+        ...schemaDriftIssues,
+        ...perfIssues,
+        ...securityIssues,
+        ...costIssues,
+    ];
+    const errors = issues.filter((i) => i.severity === 'error').length;
+    const warnings = issues.filter((i) => i.severity === 'warning').length;
+    const infos = issues.filter((i) => i.severity === 'info').length;
+    const report = {
+        summary: {
+            totalCollections: targetCollections.length,
+            totalDocuments: allDocuments.length,
+            errors,
+            warnings,
+            infos,
+            riskScore: computeRiskScore(errors, warnings, infos),
+        },
+        issues,
+        scannedAt: scanResult.scannedAt,
+    };
+    return report;
+}
+// ── Input schema ─────────────────────────────────────────────────────────────
+// NOTE: Zod 3.25.x is Zod v4 under the hood. Its types cause TS2589 ("type
+// instantiation is excessively deep") when used directly with the MCP SDK's
+// generic inference. The fix: annotate the shape as Record<string, z.ZodTypeAny>
+// to clamp TypeScript's inference depth, then validate inputs manually.
+const scanInputShape = {
+    keyPath: zod_1.z.string().describe('Absolute or relative path to the Firebase service account JSON file.'),
+    sampleSize: zod_1.z.number().int().min(1).max(500).optional().describe('Max documents to sample per collection (default: 50, max: 500).'),
+    collections: zod_1.z.array(zod_1.z.string()).optional().describe('Optional list of collection names to scan. Omit to scan all collections.'),
+};
+// Runtime validator for the handler (separate from the shape above)
+const ScanInput = zod_1.z.object({
+    keyPath: zod_1.z.string(),
+    sampleSize: zod_1.z.number().int().min(1).max(500).default(50),
+    collections: zod_1.z.array(zod_1.z.string()).optional(),
+});
+// ── Register with MCP server ──────────────────────────────────────────────────
+function registerScanTool(server) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    server.registerTool('lintbase_scan', {
+        title: 'LintBase Full Scan',
+        description: 'Runs a full LintBase scan against a Firestore database. ' +
+            'Detects schema drift, security issues, performance problems, and cost leaks. ' +
+            'Returns a structured report with a risk score and actionable issues. ' +
+            'Use this before writing any database-related code to get ground-truth schema context.',
+        inputSchema: scanInputShape,
+    }, async (rawInput) => {
+        try {
+            const { keyPath, sampleSize, collections } = ScanInput.parse(rawInput);
+            const report = await runScan(keyPath, sampleSize, collections);
+            const text = JSON.stringify(report, null, 2);
+            return {
+                content: [{ type: 'text', text }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `LintBase scan failed: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=scan.tool.js.map

package/dist/tools/scan.tool.js.map

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

package/dist/tools/schema.tool.d.ts

@@ -0,0 +1,23 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface FieldSchema {
+    name: string;
+    /** All observed types for this field (ideally just one) */
+    types: string[];
+    /** Fraction of sampled docs that contain this field (0.0–1.0) */
+    presenceRate: number;
+    /** true when presenceRate ≥ 0.8 AND only one type observed */
+    stable: boolean;
+    /** Human-readable note for unstable fields */
+    note?: string;
+}
+export interface CollectionSchema {
+    name: string;
+    sampledDocuments: number;
+    fields: FieldSchema[];
+}
+export interface SchemaReport {
+    collections: CollectionSchema[];
+    scannedAt: string;
+}
+export declare function registerSchemaTool(server: McpServer): void;
+//# sourceMappingURL=schema.tool.d.ts.map

package/dist/tools/schema.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.tool.d.ts","sourceRoot":"","sources":["../../src/tools/schema.tool.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiDpE,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACrB;AA0GD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2D1D"}

package/dist/tools/schema.tool.js

@@ -0,0 +1,229 @@
+"use strict";
+// packages/lintbase-mcp/src/tools/schema.tool.ts
+//
+// MCP Tool: lintbase_get_schema
+//
+// Returns the inferred schema for one or all Firestore collections.
+// For each collection the agent gets:
+//   - Every field name observed across sampled documents
+//   - The type(s) each field holds (e.g. "string", "timestamp", "map")
+//   - The presence rate  (0.0–1.0) — how many docs have this field
+//   - Whether the field is considered "stable" (≥ 80 % presence, single type)
+//
+// This is the killer tool for AI agents: instead of hallucinating field
+// names, the agent calls this first and gets the real shape of the DB.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSchemaTool = registerSchemaTool;
+const zod_1 = require("zod");
+const admin = __importStar(require("firebase-admin"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ── Firestore helpers (same as scan.tool.ts) ──────────────────────────────────
+function inferType(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (Array.isArray(value))
+        return 'array';
+    if (typeof value === 'object' && value !== null &&
+        'toDate' in value && typeof value.toDate === 'function')
+        return 'timestamp';
+    if (typeof value === 'object' && value !== null &&
+        'path' in value && 'id' in value)
+        return 'reference';
+    if (typeof value === 'object')
+        return 'map';
+    return typeof value;
+}
+function calculateDepth(obj, current = 1) {
+    if (typeof obj !== 'object' || obj === null || Array.isArray(obj))
+        return current;
+    const values = Object.values(obj);
+    if (values.length === 0)
+        return current;
+    return Math.max(...values.map((v) => calculateDepth(v, current + 1)));
+}
+function mapDocument(doc, collection) {
+    const rawData = doc.data();
+    const fields = {};
+    for (const [key, value] of Object.entries(rawData)) {
+        fields[key] = { value, type: inferType(value) };
+    }
+    const depth = calculateDepth(rawData);
+    const sizeBytes = (() => {
+        try {
+            return Buffer.byteLength(JSON.stringify(rawData), 'utf-8');
+        }
+        catch {
+            return 0;
+        }
+    })();
+    return { id: doc.id, collection, fields, depth, sizeBytes };
+}
+function inferCollectionSchema(docs, collectionName) {
+    const fieldTypes = new Map();
+    const fieldCounts = new Map();
+    const total = docs.length;
+    for (const doc of docs) {
+        for (const [field, { type }] of Object.entries(doc.fields)) {
+            if (!fieldTypes.has(field))
+                fieldTypes.set(field, new Set());
+            fieldTypes.get(field).add(type);
+            fieldCounts.set(field, (fieldCounts.get(field) ?? 0) + 1);
+        }
+    }
+    const fields = [];
+    for (const [name, types] of fieldTypes.entries()) {
+        const count = fieldCounts.get(name) ?? 0;
+        const presenceRate = total > 0 ? count / total : 0;
+        const typeList = [...types];
+        const stable = presenceRate >= 0.8 && typeList.length === 1;
+        let note;
+        if (typeList.length > 1) {
+            note = `Type mismatch: field holds ${typeList.join(' | ')} — schema drift detected.`;
+        }
+        else if (presenceRate < 0.6) {
+            note = `Sparse field: only present in ${Math.round(presenceRate * 100)}% of documents.`;
+        }
+        else if (presenceRate < 0.8) {
+            note = `Inconsistent field: present in ${Math.round(presenceRate * 100)}% of documents — mark as optional.`;
+        }
+        fields.push({ name, types: typeList, presenceRate, stable, note });
+    }
+    // Sort: stable fields first, then by presence rate descending
+    fields.sort((a, b) => {
+        if (a.stable !== b.stable)
+            return a.stable ? -1 : 1;
+        return b.presenceRate - a.presenceRate;
+    });
+    return { name: collectionName, sampledDocuments: total, fields };
+}
+// ── Core function ─────────────────────────────────────────────────────────────
+async function getSchema(keyPath, sampleSize, collection) {
+    const resolvedKey = path.resolve(keyPath);
+    if (!fs.existsSync(resolvedKey)) {
+        throw new Error(`Service account file not found: ${resolvedKey}`);
+    }
+    const serviceAccount = JSON.parse(fs.readFileSync(resolvedKey, 'utf-8'));
+    if (!admin.apps.length) {
+        admin.initializeApp({ credential: admin.credential.cert(serviceAccount) });
+    }
+    const db = admin.firestore();
+    // Determine which collections to scan
+    const allCollections = (await db.listCollections()).map((c) => c.id);
+    const targetCollections = collection
+        ? allCollections.filter((c) => c === collection)
+        : allCollections;
+    if (targetCollections.length === 0) {
+        throw new Error(collection
+            ? `Collection "${collection}" not found. Available: [${allCollections.join(', ')}]`
+            : 'No collections found in this Firestore database.');
+    }
+    // Sample documents and infer schema per collection
+    const collections = [];
+    for (const col of targetCollections) {
+        const snapshot = await db.collection(col).limit(sampleSize).get();
+        const docs = snapshot.docs.map((doc) => mapDocument(doc, col));
+        collections.push(inferCollectionSchema(docs, col));
+    }
+    return { collections, scannedAt: new Date().toISOString() };
+}
+// ── Input schema ──────────────────────────────────────────────────────────────
+const schemaInputShape = {
+    keyPath: zod_1.z.string().describe('Absolute or relative path to the Firebase service account JSON file.'),
+    collection: zod_1.z.string().optional().describe('Name of a single collection to inspect. Omit to get the schema of ALL collections.'),
+    sampleSize: zod_1.z.number().int().min(1).max(500).optional().describe('Max documents to sample per collection (default: 50).'),
+};
+const SchemaInput = zod_1.z.object({
+    keyPath: zod_1.z.string(),
+    collection: zod_1.z.string().optional(),
+    sampleSize: zod_1.z.number().int().min(1).max(500).default(50),
+});
+// ── Register with MCP server ──────────────────────────────────────────────────
+function registerSchemaTool(server) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    server.registerTool('lintbase_get_schema', {
+        title: 'LintBase Get Schema',
+        description: 'Returns the ground-truth schema of your Firestore collections by sampling real documents. ' +
+            'For each collection you get field names, observed types, and presence rates. ' +
+            'Use this BEFORE writing any database code to avoid hallucinating field names. ' +
+            'Stable fields (≥80% presence, single type) are safe to use. ' +
+            'Fields marked with a note need attention (drift, sparse, or optional).',
+        inputSchema: schemaInputShape,
+    }, async (rawInput) => {
+        try {
+            const { keyPath, collection, sampleSize } = SchemaInput.parse(rawInput);
+            const schemaReport = await getSchema(keyPath, sampleSize, collection);
+            // Format a clean, readable text summary the AI can reason about instantly
+            const lines = [
+                `# LintBase Schema Report`,
+                `Scanned at: ${schemaReport.scannedAt}`,
+                `Collections: ${schemaReport.collections.length}`,
+                ``,
+            ];
+            for (const col of schemaReport.collections) {
+                lines.push(`## ${col.name}  (${col.sampledDocuments} docs sampled)`);
+                lines.push(`| Field | Type(s) | Presence | Stable |`);
+                lines.push(`|-------|---------|----------|--------|`);
+                for (const f of col.fields) {
+                    const presence = `${Math.round(f.presenceRate * 100)}%`;
+                    const stable = f.stable ? '✅' : '⚠️';
+                    const note = f.note ? ` ← ${f.note}` : '';
+                    lines.push(`| ${f.name} | ${f.types.join(' | ')} | ${presence} | ${stable}${note} |`);
+                }
+                lines.push(``);
+            }
+            // Also return the raw JSON for programmatic use
+            const jsonData = JSON.stringify(schemaReport, null, 2);
+            const textSummary = lines.join('\n');
+            return {
+                content: [
+                    { type: 'text', text: textSummary },
+                    { type: 'text', text: `\n---\n**Raw JSON:**\n\`\`\`json\n${jsonData}\n\`\`\`` },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: `lintbase_get_schema failed: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=schema.tool.js.map

package/dist/tools/schema.tool.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+export interface LintBaseDocument {
+    id: string;
+    collection: string;
+    fields: Record<string, {
+        value: unknown;
+        type: string;
+    }>;
+    depth: number;
+    sizeBytes: number;
+}
+export interface LintBaseScanResult {
+    connector: string;
+    collections: string[];
+    documentCount: number;
+    documents: LintBaseDocument[];
+    scannedAt: Date;
+}
+export interface LintBaseIssue {
+    severity: 'error' | 'warning' | 'info';
+    collection: string;
+    rule: string;
+    message: string;
+    affectedDocuments?: string[];
+    suggestion?: string;
+}
+export interface LintBaseReport {
+    summary: {
+        totalCollections: number;
+        totalDocuments: number;
+        errors: number;
+        warnings: number;
+        infos: number;
+        riskScore: number;
+    };
+    issues: LintBaseIssue[];
+    scannedAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE;QACL,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,7 @@
+"use strict";
+// packages/lintbase-mcp/src/types.ts
+// Re-exports the LintBase core types.
+// The MCP package copies these (rather than importing from the CLI package)
+// so both packages can be published and versioned independently on npm.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,qCAAqC;AACrC,sCAAsC;AACtC,4EAA4E;AAC5E,wEAAwE"}

package/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "lintbase-mcp",
+    "version": "0.1.0",
+    "description": "MCP server for LintBase — give AI coding agents real-time database schema context.",
+    "main": "dist/server.js",
+    "bin": {
+        "lintbase-mcp": "dist/server.js"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md"
+    ],
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsx src/server.ts",
+        "start": "node dist/server.js",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "lintbase",
+        "mcp",
+        "model-context-protocol",
+        "firestore",
+        "database",
+        "schema",
+        "ai",
+        "cursor",
+        "claude"
+    ],
+    "author": "Mamadou Dia",
+    "license": "MIT",
+    "homepage": "https://lintbase.com",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/lintbase/lintbase.git"
+    },
+    "bugs": {
+        "url": "https://github.com/lintbase/lintbase/issues"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.27.1",
+        "firebase-admin": "^12.0.0",
+        "zod": "^3.25.76"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "tsx": "^4.7.0",
+        "typescript": "^5.3.0"
+    }
+}