firestore-mcp-readonly 0.1.1

package/dist/tools/query-collection.js

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+import { getDb } from '../db.js';
+import { serializeDocument } from '../serializer.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. Use array for "in", "not-in", "array-contains-any" operators.'),
+});
+const orderByClause = z.object({
+    field: z.string().describe('Field name to order by'),
+    direction: z.enum(['asc', 'desc']).default('asc').describe('Sort direction'),
+});
+export function registerQueryCollection(server) {
+    server.tool('firestore_query_collection', 'Query a Firestore collection with filters, ordering, and pagination. Supports all Firestore query operators. Note: complex queries may require composite indexes.', {
+        collectionPath: z.string().describe('Collection path, e.g. "users" or "tenants/t1/orders"'),
+        where: z.array(whereClause).optional()
+            .describe('Array of where filter clauses — all are ANDed together'),
+        orderBy: z.array(orderByClause).optional()
+            .describe('Array of orderBy clauses applied in order'),
+        limit: z.number().int().min(1).max(1000).optional().default(50)
+            .describe('Max documents to return (default: 50, max: 1000)'),
+        offset: z.number().int().min(0).optional().default(0)
+            .describe('Number of documents to skip (for offset-based pagination)'),
+        startAt: z.string().optional()
+            .describe('Document ID to start at (cursor-based pagination, inclusive)'),
+        startAfter: z.string().optional()
+            .describe('Document ID to start after (cursor-based pagination, exclusive)'),
+        endAt: z.string().optional()
+            .describe('Document ID to end at (inclusive)'),
+        endBefore: z.string().optional()
+            .describe('Document ID to end before (exclusive)'),
+    }, async ({ collectionPath, where: whereClauses, orderBy: orderByClauses, limit, offset, startAt, startAfter, endAt, endBefore }) => {
+        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);
+                }
+            }
+            if (orderByClauses) {
+                for (const clause of orderByClauses) {
+                    query = query.orderBy(clause.field, clause.direction);
+                }
+            }
+            if (startAt) {
+                const snap = await db.doc(`${collectionPath}/${startAt}`).get();
+                if (snap.exists)
+                    query = query.startAt(snap);
+            }
+            if (startAfter) {
+                const snap = await db.doc(`${collectionPath}/${startAfter}`).get();
+                if (snap.exists)
+                    query = query.startAfter(snap);
+            }
+            if (endAt) {
+                const snap = await db.doc(`${collectionPath}/${endAt}`).get();
+                if (snap.exists)
+                    query = query.endAt(snap);
+            }
+            if (endBefore) {
+                const snap = await db.doc(`${collectionPath}/${endBefore}`).get();
+                if (snap.exists)
+                    query = query.endBefore(snap);
+            }
+            if (offset) {
+                query = query.offset(offset);
+            }
+            query = query.limit(limit);
+            const snapshot = await query.get();
+            const documents = snapshot.docs.map(doc => serializeDocument(doc.id, doc.ref.path, doc.data()));
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            collectionPath,
+                            count: documents.length,
+                            query: {
+                                filters: whereClauses?.length ?? 0,
+                                orderBy: orderByClauses?.map(o => `${o.field} ${o.direction}`) ?? [],
+                                limit,
+                                offset,
+                            },
+                            documents,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(formatFirestoreError(error, 'firestore_query_collection'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=query-collection.js.map

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

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

package/dist/tools/read-collection-ordered.d.ts

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

package/dist/tools/read-collection-ordered.js

@@ -0,0 +1,135 @@
+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';
+const orderByClause = z.object({
+    field: z.string().describe('Field name to sort by'),
+    direction: z.enum(['asc', 'desc']).default('asc').describe('Sort direction'),
+});
+async function collectDocuments(collectionPath, depth, limiter, maxDocsPerCollection, docs) {
+    limiter.checkDepth(depth);
+    const db = getDb();
+    const snapshot = await db.collection(collectionPath).limit(maxDocsPerCollection).get();
+    limiter.addDocs(snapshot.docs.length);
+    for (const doc of snapshot.docs) {
+        docs.push(serializeDocument(doc.id, doc.ref.path, doc.data()));
+        const subcollections = await doc.ref.listCollections();
+        for (const sub of subcollections) {
+            await collectDocuments(sub.path, depth + 1, limiter, maxDocsPerCollection, docs);
+        }
+    }
+}
+function getSortValue(doc, field) {
+    const val = doc[field];
+    if (val === undefined || val === null)
+        return undefined;
+    if (typeof val === 'object' && val !== null && '_type' in val) {
+        const typed = val;
+        if (typed._type === 'timestamp')
+            return typed.value;
+        if (typed._type === 'geopoint')
+            return typed.lat;
+        if (typed._type === 'reference')
+            return typed.path;
+    }
+    return val;
+}
+function compareValues(a, b, direction) {
+    const aUndef = a === undefined || a === null;
+    const bUndef = b === undefined || b === null;
+    if (aUndef && bUndef)
+        return 0;
+    if (aUndef)
+        return 1;
+    if (bUndef)
+        return -1;
+    let result = 0;
+    if (typeof a === 'number' && typeof b === 'number') {
+        result = a - b;
+    }
+    else {
+        result = String(a).localeCompare(String(b));
+    }
+    return direction === 'desc' ? -result : result;
+}
+export function registerReadCollectionOrdered(server, config) {
+    server.tool('firestore_read_collection_ordered', 'Recursively read all documents from a collection and its subcollections, returning a flat list sorted by one or more fields. Useful for getting an ordered view across an entire document hierarchy.', {
+        collectionPath: z.string().describe('Collection path, e.g. "users" or "tenants/t1/projects"'),
+        orderBy: z.array(orderByClause).min(1)
+            .describe('Fields to sort by, applied in order. First entry is primary sort, rest are tiebreakers.'),
+        limit: z.number().int().min(1).max(1000).optional().default(100)
+            .describe('Max documents to return after sorting (default: 100, max: 1000)'),
+        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 ({ collectionPath, orderBy: orderByClauses, limit, maxDepth, maxDocs }) => {
+        const limiter = new DumpLimiter(maxDocs ?? config.limits.maxTotalDumpDocs, maxDepth ?? config.limits.maxRecursionDepth);
+        try {
+            const segments = collectionPath.split('/').filter(Boolean);
+            if (segments.length === 0 || segments.length % 2 !== 1) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: `Invalid collection path "${collectionPath}": must have an odd number of segments. Got ${segments.length} segment(s).`,
+                            }),
+                        }],
+                    isError: true,
+                };
+            }
+            const docs = [];
+            await collectDocuments(collectionPath, 0, limiter, config.limits.maxDocsPerCollection, docs);
+            docs.sort((a, b) => {
+                for (const clause of orderByClauses) {
+                    const aVal = getSortValue(a, clause.field);
+                    const bVal = getSortValue(b, clause.field);
+                    const cmp = compareValues(aVal, bVal, clause.direction);
+                    if (cmp !== 0)
+                        return cmp;
+                }
+                return 0;
+            });
+            const limited = docs.slice(0, limit);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            collectionPath,
+                            orderBy: orderByClauses.map(o => `${o.field} ${o.direction}`),
+                            totalDocsRead: limiter.docsProcessed,
+                            count: limited.length,
+                            truncatedByLimit: docs.length > limit,
+                            limitReached: false,
+                            documents: limited,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            if (error instanceof LimitExceededError) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                collectionPath,
+                                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_read_collection_ordered'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=read-collection-ordered.js.map

package/dist/tools/read-collection-ordered.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "firestore-mcp-readonly",
+  "version": "0.1.1",
+  "description": "Read-only Firestore MCP server for AI agents — query, explore, and dump Firestore databases via Model Context Protocol",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "firestore-mcp-readonly": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --passWithNoTests",
+    "lint": "eslint src/"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "firebase-admin": "^13.10.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^22.0.0",
+    "cross-env": "^10.1.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.3.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "firestore",
+    "firebase",
+    "google-cloud",
+    "google-cloud-firestore",
+    "gcp",
+    "database",
+    "nosql",
+    "readonly",
+    "model-context-protocol",
+    "ai-agent",
+    "ai-tools",
+    "claude",
+    "claude-mcp",
+    "cursor",
+    "ai"
+  ],
+  "author": "rilfi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rilfi/firestore-mcp-readonly.git"
+  },
+  "homepage": "https://github.com/rilfi/firestore-mcp-readonly#readme",
+  "bugs": {
+    "url": "https://github.com/rilfi/firestore-mcp-readonly/issues"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}