firestore-mcp-readonly 0.1.1

package/dist/tools/count-documents.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { formatFirestoreError } from '../errors.js';
+const whereClause = z.object({
+    field: z.string().describe('Field name to filter on'),
+    op: z.enum(['==', '!=', '<', '<=', '>', '>=', 'array-contains', 'array-contains-any', 'in', 'not-in'])
+        .describe('Firestore comparison operator'),
+    value: z.union([
+        z.string(),
+        z.number(),
+        z.boolean(),
+        z.null(),
+        z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])),
+    ]).describe('Value to compare against'),
+});
+export function registerCountDocuments(server) {
+    server.tool('firestore_count_documents', 'Count documents in a collection or matching a query without fetching the actual document data. Efficient aggregate operation.', {
+        collectionPath: z.string().describe('Collection path, e.g. "users" or "tenants/t1/projects"'),
+        where: z.array(whereClause).optional()
+            .describe('Optional where filter clauses — all are ANDed together'),
+    }, async ({ collectionPath, where: whereClauses }) => {
+        try {
+            const db = getDb();
+            let query = db.collection(collectionPath);
+            if (whereClauses) {
+                for (const clause of whereClauses) {
+                    query = query.where(clause.field, clause.op, clause.value);
+                }
+            }
+            const snapshot = await query.count().get();
+            const count = snapshot.data().count;
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            collectionPath,
+                            count,
+                            filters: whereClauses?.length ?? 0,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_count_documents'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=count-documents.js.map

package/dist/tools/count-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-documents.js","sourceRoot":"","sources":["../../src/tools/count-documents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACrD,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;SACnG,QAAQ,CAAC,+BAA+B,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC;QACb,CAAC,CAAC,MAAM,EAAE;QACV,CAAC,CAAC,MAAM,EAAE;QACV,CAAC,CAAC,OAAO,EAAE;QACX,CAAC,CAAC,IAAI,EAAE;QACR,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;KAClE,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,+HAA+H,EAC/H;QACE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QAC7F,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;aACnC,QAAQ,CAAC,wDAAwD,CAAC;KACtE,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;YACnB,IAAI,KAAK,GAAwB,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YAE/D,IAAI,YAAY,EAAE,CAAC;gBACjB,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;oBAClC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,cAAc;4BACd,KAAK;4BACL,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;yBACnC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,2BAA2B,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxF,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/dump-database.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FirestoreConfig } from '../config.js';
+export declare function registerDumpDatabase(server: McpServer, config: FirestoreConfig): void;

package/dist/tools/dump-database.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { serializeDocument } from '../serializer.js';
+import { DumpLimiter, LimitExceededError } from '../limiter.js';
+import { formatFirestoreError } from '../errors.js';
+async function dumpCollectionRecursive(collectionPath, depth, limiter, maxDocsPerCollection) {
+    limiter.checkDepth(depth);
+    const db = getDb();
+    const snapshot = await db.collection(collectionPath).limit(maxDocsPerCollection).get();
+    limiter.addDocs(snapshot.docs.length);
+    const result = {
+        _type: 'collection',
+        _path: collectionPath,
+        _documentCount: snapshot.docs.length,
+        documents: {},
+    };
+    const documents = result.documents;
+    for (const doc of snapshot.docs) {
+        const serialized = serializeDocument(doc.id, doc.ref.path, doc.data());
+        const subcollections = await doc.ref.listCollections();
+        if (subcollections.length > 0) {
+            const subs = {};
+            for (const sub of subcollections) {
+                subs[sub.id] = await dumpCollectionRecursive(sub.path, depth + 1, limiter, maxDocsPerCollection);
+            }
+            serialized._subcollections = subs;
+        }
+        documents[doc.id] = serialized;
+    }
+    return result;
+}
+export function registerDumpDatabase(server, config) {
+    server.tool('firestore_dump_database', 'Recursively dump the entire Firestore database. Lists all root-level collections and traverses each one depth-first. Returns a nested tree of all documents and subcollections. Use with caution on large databases — configure limits via env vars or parameters.', {
+        maxDepth: z.number().int().min(1).max(15).optional()
+            .describe('Override max recursion depth (default from server config)'),
+        maxDocs: z.number().int().min(1).max(10000).optional()
+            .describe('Override max total documents to read (default from server config)'),
+        excludeCollections: z.array(z.string()).optional()
+            .describe('Root collection IDs to skip, e.g. ["_metadata", "_temp"]'),
+    }, async ({ maxDepth, maxDocs, excludeCollections }) => {
+        const limiter = new DumpLimiter(maxDocs ?? config.limits.maxTotalDumpDocs, maxDepth ?? config.limits.maxRecursionDepth);
+        try {
+            const db = getDb();
+            const rootCollections = await db.listCollections();
+            const excludeSet = new Set(excludeCollections ?? []);
+            const filtered = rootCollections.filter(col => !excludeSet.has(col.id));
+            const rootNames = filtered.map(col => col.id);
+            const data = {};
+            for (const col of filtered) {
+                data[col.id] = await dumpCollectionRecursive(col.path, 0, limiter, config.limits.maxDocsPerCollection);
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            rootCollections: rootNames,
+                            excludedCollections: excludeCollections ?? [],
+                            totalDocsRead: limiter.docsProcessed,
+                            limitReached: false,
+                            data,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            if (error instanceof LimitExceededError) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                totalDocsRead: limiter.docsProcessed,
+                                limitReached: true,
+                                limitReason: error.message,
+                                note: 'Partial data returned. Use excludeCollections or lower maxDocs/maxDepth to narrow scope.',
+                            }, null, 2),
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_dump_database'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=dump-database.js.map

package/dist/tools/dump-database.js.map

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

package/dist/tools/dump-node.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FirestoreConfig } from '../config.js';
+export declare function registerDumpNode(server: McpServer, config: FirestoreConfig): void;

package/dist/tools/dump-node.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { serializeDocument } from '../serializer.js';
+import { DumpLimiter, LimitExceededError } from '../limiter.js';
+import { formatFirestoreError } from '../errors.js';
+async function dumpCollection(collectionPath, depth, limiter, maxDocsPerCollection) {
+    limiter.checkDepth(depth);
+    const db = getDb();
+    const snapshot = await db.collection(collectionPath).limit(maxDocsPerCollection).get();
+    limiter.addDocs(snapshot.docs.length);
+    const result = {
+        _type: 'collection',
+        _path: collectionPath,
+        _documentCount: snapshot.docs.length,
+        documents: {},
+    };
+    const documents = result.documents;
+    for (const doc of snapshot.docs) {
+        const serialized = serializeDocument(doc.id, doc.ref.path, doc.data());
+        const subcollections = await doc.ref.listCollections();
+        if (subcollections.length > 0) {
+            const subs = {};
+            for (const sub of subcollections) {
+                subs[sub.id] = await dumpCollection(sub.path, depth + 1, limiter, maxDocsPerCollection);
+            }
+            serialized._subcollections = subs;
+        }
+        documents[doc.id] = serialized;
+    }
+    return result;
+}
+async function dumpDocument(documentPath, depth, limiter, maxDocsPerCollection) {
+    const db = getDb();
+    const docRef = db.doc(documentPath);
+    const snapshot = await docRef.get();
+    if (!snapshot.exists) {
+        return { _type: 'document', _path: documentPath, exists: false };
+    }
+    limiter.addDocs(1);
+    const serialized = serializeDocument(snapshot.id, snapshot.ref.path, snapshot.data());
+    const subcollections = await docRef.listCollections();
+    if (subcollections.length > 0) {
+        const subs = {};
+        for (const sub of subcollections) {
+            subs[sub.id] = await dumpCollection(sub.path, depth + 1, limiter, maxDocsPerCollection);
+        }
+        serialized._subcollections = subs;
+    }
+    return serialized;
+}
+export function registerDumpNode(server, config) {
+    server.tool('firestore_dump_node', 'Recursively dump all documents and subcollections under a given Firestore path. Works with both document paths (even segments) and collection paths (odd segments). Returns a nested tree structure. Respects configurable depth and document count limits to prevent excessive reads.', {
+        path: z.string().describe('Starting path — document (e.g. "users/alice") or collection (e.g. "users")'),
+        maxDepth: z.number().int().min(1).max(20).optional()
+            .describe('Override max recursion depth (default from server config)'),
+        maxDocs: z.number().int().min(1).max(10000).optional()
+            .describe('Override max total documents to read (default from server config)'),
+    }, async ({ path, maxDepth, maxDocs }) => {
+        const limiter = new DumpLimiter(maxDocs ?? config.limits.maxTotalDumpDocs, maxDepth ?? config.limits.maxRecursionDepth);
+        try {
+            const segments = path.split('/').filter(Boolean);
+            const isDocument = segments.length % 2 === 0;
+            let data;
+            if (isDocument) {
+                data = await dumpDocument(path, 0, limiter, config.limits.maxDocsPerCollection);
+            }
+            else {
+                data = await dumpCollection(path, 0, limiter, config.limits.maxDocsPerCollection);
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            rootPath: path,
+                            totalDocsRead: limiter.docsProcessed,
+                            limitReached: false,
+                            data,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            if (error instanceof LimitExceededError) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                rootPath: path,
+                                totalDocsRead: limiter.docsProcessed,
+                                limitReached: true,
+                                limitReason: error.message,
+                                note: 'Partial data returned. Use a narrower path or increase limits.',
+                            }, null, 2),
+                        }],
+                };
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_dump_node'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=dump-node.js.map

package/dist/tools/dump-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump-node.js","sourceRoot":"","sources":["../../src/tools/dump-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAMpD,KAAK,UAAU,cAAc,CAC3B,cAAsB,EACtB,KAAa,EACb,OAAoB,EACpB,oBAA4B;IAE5B,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,EAAE,CAAC;IACvF,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAe;QACzB,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,cAAc;QACrB,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;QACpC,SAAS,EAAE,EAA6B;KACzC,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,CAAC,SAAoC,CAAC;IAC9D,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACvE,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAEvD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;gBACjC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;YAC1F,CAAC;YACA,UAAsC,CAAC,eAAe,GAAG,IAAI,CAAC;QACjE,CAAC;QAED,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,YAAoB,EACpB,KAAa,EACb,OAAoB,EACpB,oBAA4B;IAE5B,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;IAEpC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAG,CAAe,CAAC;IACrG,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;IAEtD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAC1F,CAAC;QACD,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC;IACpC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAuB;IACzE,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,wRAAwR,EACxR;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;QACvG,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;aACjD,QAAQ,CAAC,2DAA2D,CAAC;QACxE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;aACnD,QAAQ,CAAC,mEAAmE,CAAC;KACjF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,WAAW,CAC7B,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,EACzC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAC5C,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;YAE7C,IAAI,IAAgB,CAAC;YACrB,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAClF,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YACpF,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,QAAQ,EAAE,IAAI;4BACd,aAAa,EAAE,OAAO,CAAC,aAAa;4BACpC,YAAY,EAAE,KAAK;4BACnB,IAAI;yBACL,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,QAAQ,EAAE,IAAI;gCACd,aAAa,EAAE,OAAO,CAAC,aAAa;gCACpC,YAAY,EAAE,IAAI;gCAClB,WAAW,EAAE,KAAK,CAAC,OAAO;gCAC1B,IAAI,EAAE,gEAAgE;6BACvE,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ,CAAC;iBACH,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,qBAAqB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBAClF,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-collection.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FirestoreConfig } from '../config.js';
+export declare function registerGetCollection(server: McpServer, config: FirestoreConfig): void;

package/dist/tools/get-collection.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { serializeDocument } from '../serializer.js';
+import { formatFirestoreError } from '../errors.js';
+export function registerGetCollection(server, config) {
+    server.tool('firestore_get_collection', 'Get all documents from a Firestore collection by its full path. Returns documents with optional limit.', {
+        path: z.string().describe('Full collection path, e.g. "users" or "tenants/t1/projects"'),
+        limit: z.number().int().min(1).max(1000).optional()
+            .describe('Max documents to return. Defaults to server max (configurable, default 500). Hard cap: 1000.'),
+    }, async ({ path, limit }) => {
+        try {
+            const segments = path.split('/').filter(Boolean);
+            if (segments.length === 0 || segments.length % 2 !== 1) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: `Invalid collection path "${path}": must have an odd number of segments. Got ${segments.length} segment(s).`,
+                            }),
+                        }],
+                    isError: true,
+                };
+            }
+            const db = getDb();
+            const effectiveLimit = Math.min(limit ?? config.limits.maxDocsPerCollection, 1000);
+            const snapshot = await db.collection(path).limit(effectiveLimit + 1).get();
+            const truncated = snapshot.docs.length > effectiveLimit;
+            const docs = snapshot.docs.slice(0, effectiveLimit);
+            const documents = docs.map(doc => serializeDocument(doc.id, doc.ref.path, doc.data()));
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            collectionPath: path,
+                            count: documents.length,
+                            truncated,
+                            documents,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_get_collection'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-collection.js.map

package/dist/tools/get-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-collection.js","sourceRoot":"","sources":["../../src/tools/get-collection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAuB;IAC9E,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,wGAAwG,EACxG;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;QACxF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;aAChD,QAAQ,CAAC,8FAA8F,CAAC;KAC5G,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,4BAA4B,IAAI,+CAA+C,QAAQ,CAAC,MAAM,cAAc;6BACpH,CAAC;yBACH,CAAC;oBACF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;YACnB,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;YACnF,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAE3E,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;YACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YAEpD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAC/B,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CACpD,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,cAAc,EAAE,IAAI;4BACpB,KAAK,EAAE,SAAS,CAAC,MAAM;4BACvB,SAAS;4BACT,SAAS;yBACV,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,0BAA0B,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACvF,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-document.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGetDocument(server: McpServer): void;

package/dist/tools/get-document.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { serializeDocument } from '../serializer.js';
+import { formatFirestoreError } from '../errors.js';
+export function registerGetDocument(server) {
+    server.tool('firestore_get_document', 'Get a single Firestore document by its full path. Path must have an even number of segments (collection/doc pairs), e.g. "users/alice" or "tenants/t1/projects/p1".', {
+        path: z.string().describe('Full document path, e.g. "users/alice" or "tenants/t1/projects/p1/docs/d1"'),
+    }, async ({ path }) => {
+        try {
+            const segments = path.split('/').filter(Boolean);
+            if (segments.length === 0 || segments.length % 2 !== 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: `Invalid document path "${path}": must have an even number of segments (collection/doc pairs). Got ${segments.length} segment(s).`,
+                            }),
+                        }],
+                    isError: true,
+                };
+            }
+            const db = getDb();
+            const docRef = db.doc(path);
+            const snapshot = await docRef.get();
+            if (!snapshot.exists) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({ exists: false, path }),
+                        }],
+                };
+            }
+            const result = serializeDocument(snapshot.id, snapshot.ref.path, snapshot.data());
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_get_document'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-document.js.map

package/dist/tools/get-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document.js","sourceRoot":"","sources":["../../src/tools/get-document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,qKAAqK,EACrK;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;KACxG,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,0BAA0B,IAAI,uEAAuE,QAAQ,CAAC,MAAM,cAAc;6BAC1I,CAAC;yBACH,CAAC;oBACF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;YAEpC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACrB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;yBAC9C,CAAC;iBACH,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAG,CAAC,CAAC;YAEnF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACrF,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-server-info.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FirestoreConfig } from '../config.js';
+export declare function registerGetServerInfo(server: McpServer, config: FirestoreConfig): void;

package/dist/tools/get-server-info.js

@@ -0,0 +1,31 @@
+import { getDb } from '../db.js';
+import { formatFirestoreError } from '../errors.js';
+export function registerGetServerInfo(server, config) {
+    server.tool('firestore_get_server_info', 'Get the MCP server configuration summary: project ID, database ID, and active safety limits. Useful for verifying you are connected to the correct Firestore database.', {}, async () => {
+        try {
+            const db = getDb();
+            const rootCollections = await db.listCollections();
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            projectId: config.projectId,
+                            databaseId: config.databaseId,
+                            limits: config.limits,
+                            rootCollections: rootCollections.map(col => col.id),
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_get_server_info'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-server-info.js.map

package/dist/tools/get-server-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-server-info.js","sourceRoot":"","sources":["../../src/tools/get-server-info.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAuB;IAC9E,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,wKAAwK,EACxK,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;YACnB,MAAM,eAAe,GAAG,MAAM,EAAE,CAAC,eAAe,EAAE,CAAC;YAEnD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,SAAS,EAAE,MAAM,CAAC,SAAS;4BAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;4BAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;4BACrB,eAAe,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;yBACpD,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,2BAA2B,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxF,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-indexes.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FirestoreConfig } from '../config.js';
+export declare function registerListIndexes(server: McpServer, config: FirestoreConfig): void;

package/dist/tools/list-indexes.js

@@ -0,0 +1,92 @@
+import { getApps } from 'firebase-admin/app';
+import { formatFirestoreError } from '../errors.js';
+export function registerListIndexes(server, config) {
+    server.tool('firestore_list_indexes', 'List all composite indexes defined for the Firestore database. Useful for understanding what queries are efficiently supported and diagnosing "missing index" errors.', {}, async () => {
+        try {
+            const app = getApps()[0];
+            const credential = app.options.credential;
+            if (!credential) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({ error: 'No credential available to list indexes' }),
+                        }],
+                    isError: true,
+                };
+            }
+            const token = await credential.getAccessToken();
+            const dbPath = config.databaseId === '(default)' ? '(default)' : config.databaseId;
+            const url = `https://firestore.googleapis.com/v1/projects/${config.projectId}/databases/${dbPath}/collectionGroups/-/indexes`;
+            const response = await fetch(url, {
+                headers: { Authorization: `Bearer ${token.access_token}` },
+            });
+            if (!response.ok) {
+                const body = await response.text();
+                let parsedError = {};
+                try {
+                    parsedError = JSON.parse(body);
+                }
+                catch { /* raw text fallback */ }
+                const errorMessage = typeof parsedError.error === 'object' && parsedError.error !== null
+                    ? parsedError.error.message || `HTTP ${response.status} ${response.statusText}`
+                    : `HTTP ${response.status} ${response.statusText}`;
+                const httpStatus = response.status;
+                let suggestion = 'Check the error details for more information.';
+                if (httpStatus === 403) {
+                    suggestion = 'The service account lacks permission to list indexes. Ensure it has the Cloud Datastore Index Admin role (roles/datastore.indexAdmin) in the GCP IAM console.';
+                }
+                else if (httpStatus === 404) {
+                    suggestion = 'The project or database was not found. Verify FIRESTORE_PROJECT_ID and FIRESTORE_DATABASE_ID.';
+                }
+                else if (httpStatus === 401) {
+                    suggestion = 'Authentication failed. The service account credentials may be invalid or expired. Check FIRESTORE_SERVICE_ACCOUNT_KEY_PATH.';
+                }
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: errorMessage,
+                                code: `HTTP_${httpStatus}`,
+                                tool: 'firestore_list_indexes',
+                                suggestion,
+                                details: body,
+                            }, null, 2),
+                        }],
+                    isError: true,
+                };
+            }
+            const data = await response.json();
+            const indexes = (data.indexes ?? []).map(idx => ({
+                name: idx.name.split('/').pop(),
+                queryScope: idx.queryScope,
+                fields: idx.fields.map(f => ({
+                    fieldPath: f.fieldPath,
+                    ...(f.order ? { order: f.order } : {}),
+                    ...(f.arrayConfig ? { arrayConfig: f.arrayConfig } : {}),
+                })),
+                state: idx.state,
+            }));
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            projectId: config.projectId,
+                            databaseId: config.databaseId,
+                            count: indexes.length,
+                            indexes,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_list_indexes'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-indexes.js.map

package/dist/tools/list-indexes.js.map

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

package/dist/tools/list-subcollections.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerListSubcollections(server: McpServer): void;

package/dist/tools/list-subcollections.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { formatFirestoreError } from '../errors.js';
+export function registerListSubcollections(server) {
+    server.tool('firestore_list_subcollections', 'List all subcollection names directly under a document. This is an Admin SDK exclusive feature — client SDKs cannot enumerate subcollections.', {
+        documentPath: z.string().describe('Full document path, e.g. "users/alice" or "tenants/t1/projects/p1"'),
+    }, async ({ documentPath }) => {
+        try {
+            const segments = documentPath.split('/').filter(Boolean);
+            if (segments.length === 0 || segments.length % 2 !== 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: `Invalid document path "${documentPath}": must have an even number of segments.`,
+                            }),
+                        }],
+                    isError: true,
+                };
+            }
+            const db = getDb();
+            const collections = await db.doc(documentPath).listCollections();
+            const subcollections = collections.map(col => col.id);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            documentPath,
+                            count: subcollections.length,
+                            subcollections,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_list_subcollections'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-subcollections.js.map

package/dist/tools/list-subcollections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-subcollections.js","sourceRoot":"","sources":["../../src/tools/list-subcollections.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,IAAI,CACT,+BAA+B,EAC/B,+IAA+I,EAC/I;QACE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;KACxG,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,0BAA0B,YAAY,0CAA0C;6BACxF,CAAC;yBACH,CAAC;oBACF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;YACnB,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,eAAe,EAAE,CAAC;YACjE,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEtD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,YAAY;4BACZ,KAAK,EAAE,cAAc,CAAC,MAAM;4BAC5B,cAAc;yBACf,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,KAAK,EAAE,+BAA+B,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC5F,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/query-collection.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerQueryCollection(server: McpServer): void;