firestore-mcp-readonly 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rilfi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# firestore-mcp-readonly
+
+[![npm version](https://img.shields.io/npm/v/firestore-mcp-readonly)](https://www.npmjs.com/package/firestore-mcp-readonly)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js >= 18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+
+A read-only [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for Google Cloud Firestore. Gives AI agents full read access to any Firestore database — query documents, explore subcollections, dump entire hierarchies — without any write capabilities.
+
+## Features
+
+| Tool | Description |
+|------|-------------|
+| `firestore_get_document` | Get a single document by full path |
+| `firestore_get_collection` | Get all documents from a collection |
+| `firestore_query_collection` | Query with filters, ordering, pagination, cursors |
+| `firestore_collection_group_query` | Query across all collections with the same ID |
+| `firestore_list_subcollections` | List subcollection names under a document |
+| `firestore_count_documents` | Count documents matching a query (aggregate) |
+| `firestore_list_indexes` | List composite indexes in the database |
+| `firestore_dump_node` | Recursively dump a subtree (documents + subcollections) |
+| `firestore_dump_database` | Recursively dump the entire database |
+| `firestore_read_collection_ordered` | Recursively read all documents from a collection and subcollections, returned as a flat sorted list |
+| `firestore_get_server_info` | Get project ID, database ID, limits, root collections |
+
+### Query Operators
+
+All Firestore query operators are supported:
+
+`==`, `!=`, `<`, `<=`, `>`, `>=`, `array-contains`, `array-contains-any`, `in`, `not-in`
+
+### Pagination
+
+- Offset-based: `limit` + `offset`
+- Cursor-based: `startAt`, `startAfter`, `endAt`, `endBefore` (by document ID)
+
+### Type Serialization
+
+Firestore-specific types are converted to JSON-safe objects:
+
+| Firestore Type | JSON Output |
+|---------------|-------------|
+| Timestamp | `{ "_type": "timestamp", "value": "2024-01-01T00:00:00.000Z" }` |
+| GeoPoint | `{ "_type": "geopoint", "lat": 37.7749, "lng": -122.4194 }` |
+| DocumentReference | `{ "_type": "reference", "path": "users/alice" }` |
+| Bytes | `{ "_type": "bytes", "base64": "..." }` |
+
+## Setup
+
+### Prerequisites
+
+- Node.js >= 18
+- A GCP service account key (see below)
+
+### Service Account Setup
+
+1. **Open the GCP Console**
+   Go to [IAM & Admin > Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts) and select your project.
+
+2. **Create a service account**
+   Click **Create Service Account**. Use a descriptive name like `firestore-mcp-reader`. You can skip the optional description.
+
+3. **Assign roles**
+   On the "Grant this service account access to project" step, add:
+
+   | Role | Role ID | Purpose |
+   |------|---------|---------|
+   | Cloud Datastore Viewer | `roles/datastore.viewer` | **Required.** Read documents, query collections, list subcollections, count, and dump. |
+   | Cloud Datastore Index Admin | `roles/datastore.indexAdmin` | **Optional.** Only needed for the `firestore_list_indexes` tool. |
+
+   Click **Done** to finish creating the service account.
+
+4. **Create a JSON key**
+   Click on the newly created service account, go to the **Keys** tab, click **Add Key > Create new key**, select **JSON**, and click **Create**. A `.json` file will download automatically.
+
+5. **Store the key securely**
+   Move the downloaded file to a secure location (e.g. `~/.config/gcloud/firestore-mcp-reader.json`). This path goes into the `FIRESTORE_SERVICE_ACCOUNT_KEY_PATH` environment variable.
+
+   > **Do not commit the key file to version control.** Add it to your `.gitignore`.
+
+### Install globally (recommended)
+
+```bash
+npm install -g firestore-mcp-readonly
+```
+
+Then add to your MCP config (e.g. `claude_desktop_config.json`, `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "firestore": {
+      "command": "firestore-mcp-readonly",
+      "env": {
+        "FIRESTORE_SERVICE_ACCOUNT_KEY_PATH": "/path/to/service-account.json",
+        "FIRESTORE_PROJECT_ID": "my-gcp-project",
+        "FIRESTORE_DATABASE_ID": "(default)",
+        "FIRESTORE_MAX_DOCS_PER_COLLECTION": "500",
+        "FIRESTORE_MAX_RECURSION_DEPTH": "10",
+        "FIRESTORE_MAX_TOTAL_DUMP_DOCS": "5000"
+      }
+    }
+  }
+}
+```
+
+
+## Configuration
+
+All configuration is via environment variables (set in the `env` block of `.mcp.json`):
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `FIRESTORE_SERVICE_ACCOUNT_KEY_PATH` | Yes | — | Absolute path to service account JSON key file |
+| `FIRESTORE_PROJECT_ID` | Yes | — | GCP project ID |
+| `FIRESTORE_DATABASE_ID` | No | `(default)` | Named database ID |
+| `FIRESTORE_MAX_DOCS_PER_COLLECTION` | No | `500` | Max docs per single collection fetch |
+| `FIRESTORE_MAX_RECURSION_DEPTH` | No | `10` | Max depth for recursive dumps |
+| `FIRESTORE_MAX_TOTAL_DUMP_DOCS` | No | `5000` | Max total docs across a dump operation |
+
+## Safety
+
+- **Read-only**: No create, update, or delete operations are exposed
+- **Depth limits**: Recursive dumps stop at configurable depth
+- **Document caps**: Total documents per dump are capped
+- **Partial results**: When limits are hit, partial data is returned with `limitReached: true` instead of erroring
+- **No secrets exposed**: `firestore_get_server_info` never returns the service account key
+
+## Contributing
+
+Contributions are welcome! Please submit your pull requests to the `develop` branch. PRs targeting any other branch will not be accepted.
+
+### Branch Naming
+
+- Features: `feature/FSMCP-<number>-<description>`
+- Bug fixes: `bugfix/FSMCP-<number>-<description>`
+
+### Branch Flow
+
+```text
+main ← release/x.x.x ← develop ← feature/FSMCP-xxx
+                                 ← bugfix/FSMCP-xxx
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+export interface FirestoreConfig {
+    serviceAccountKeyPath: string;
+    projectId: string;
+    databaseId: string;
+    limits: {
+        maxDocsPerCollection: number;
+        maxRecursionDepth: number;
+        maxTotalDumpDocs: number;
+    };
+}
+export declare function loadConfig(): FirestoreConfig;

package/dist/config.js

@@ -0,0 +1,37 @@
+import { existsSync } from 'fs';
+export function loadConfig() {
+    const serviceAccountKeyPath = process.env.FIRESTORE_SERVICE_ACCOUNT_KEY_PATH;
+    const projectId = process.env.FIRESTORE_PROJECT_ID;
+    if (!serviceAccountKeyPath) {
+        throw new Error('FIRESTORE_SERVICE_ACCOUNT_KEY_PATH environment variable is required');
+    }
+    if (!projectId) {
+        throw new Error('FIRESTORE_PROJECT_ID environment variable is required');
+    }
+    if (!existsSync(serviceAccountKeyPath)) {
+        throw new Error(`Service account key file not found: ${serviceAccountKeyPath}`);
+    }
+    const maxDocsPerCollection = parseInt(process.env.FIRESTORE_MAX_DOCS_PER_COLLECTION || '500', 10);
+    const maxRecursionDepth = parseInt(process.env.FIRESTORE_MAX_RECURSION_DEPTH || '10', 10);
+    const maxTotalDumpDocs = parseInt(process.env.FIRESTORE_MAX_TOTAL_DUMP_DOCS || '5000', 10);
+    if (isNaN(maxDocsPerCollection)) {
+        throw new Error(`FIRESTORE_MAX_DOCS_PER_COLLECTION must be a number, got "${process.env.FIRESTORE_MAX_DOCS_PER_COLLECTION}"`);
+    }
+    if (isNaN(maxRecursionDepth)) {
+        throw new Error(`FIRESTORE_MAX_RECURSION_DEPTH must be a number, got "${process.env.FIRESTORE_MAX_RECURSION_DEPTH}"`);
+    }
+    if (isNaN(maxTotalDumpDocs)) {
+        throw new Error(`FIRESTORE_MAX_TOTAL_DUMP_DOCS must be a number, got "${process.env.FIRESTORE_MAX_TOTAL_DUMP_DOCS}"`);
+    }
+    return {
+        serviceAccountKeyPath,
+        projectId,
+        databaseId: process.env.FIRESTORE_DATABASE_ID || '(default)',
+        limits: {
+            maxDocsPerCollection,
+            maxRecursionDepth,
+            maxTotalDumpDocs,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAahC,MAAM,UAAU,UAAU;IACxB,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAEnD,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,uCAAuC,qBAAqB,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,oBAAoB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;IAClG,MAAM,iBAAiB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAE3F,IAAI,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,4DAA4D,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,CAAC,CAAC;IAChI,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,wDAAwD,OAAO,CAAC,GAAG,CAAC,6BAA6B,GAAG,CAAC,CAAC;IACxH,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wDAAwD,OAAO,CAAC,GAAG,CAAC,6BAA6B,GAAG,CAAC,CAAC;IACxH,CAAC;IAED,OAAO;QACL,qBAAqB;QACrB,SAAS;QACT,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,WAAW;QAC5D,MAAM,EAAE;YACN,oBAAoB;YACpB,iBAAiB;YACjB,gBAAgB;SACjB;KACF,CAAC;AACJ,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,4 @@
+import { type Firestore } from 'firebase-admin/firestore';
+import type { FirestoreConfig } from './config.js';
+export declare function initDb(config: FirestoreConfig): void;
+export declare function getDb(): Firestore;

package/dist/db.js

@@ -0,0 +1,49 @@
+import { initializeApp, getApps, cert } from 'firebase-admin/app';
+import { getFirestore } from 'firebase-admin/firestore';
+import { readFileSync } from 'fs';
+let db = null;
+export function initDb(config) {
+    if (getApps().length === 0) {
+        let raw;
+        try {
+            raw = readFileSync(config.serviceAccountKeyPath, 'utf-8');
+        }
+        catch (err) {
+            throw new Error(`Failed to read service account key file at "${config.serviceAccountKeyPath}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        let serviceAccount;
+        try {
+            serviceAccount = JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`Service account key file at "${config.serviceAccountKeyPath}" is not valid JSON`);
+        }
+        if (!serviceAccount.client_email || typeof serviceAccount.client_email !== 'string') {
+            throw new Error(`Service account key file is missing "client_email" field. Ensure you downloaded a JSON key (not a P12 key) from the GCP console.`);
+        }
+        if (!serviceAccount.private_key || typeof serviceAccount.private_key !== 'string') {
+            throw new Error(`Service account key file is missing "private_key" field. Ensure you downloaded a JSON key (not a P12 key) from the GCP console.`);
+        }
+        try {
+            initializeApp({
+                credential: cert(serviceAccount),
+                projectId: config.projectId,
+            });
+        }
+        catch (err) {
+            throw new Error(`Failed to initialize Firebase Admin with the service account at "${config.serviceAccountKeyPath}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (config.databaseId !== '(default)') {
+        db = getFirestore(config.databaseId);
+    }
+    else {
+        db = getFirestore();
+    }
+}
+export function getDb() {
+    if (!db)
+        throw new Error('Firestore not initialized — call initDb() first');
+    return db;
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAkB,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAGlC,IAAI,EAAE,GAAqB,IAAI,CAAC;AAEhC,MAAM,UAAU,MAAM,CAAC,MAAuB;IAC5C,IAAI,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,+CAA+C,MAAM,CAAC,qBAAqB,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvJ,CAAC;QAED,IAAI,cAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,qBAAqB,qBAAqB,CAAC,CAAC;QACrG,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,YAAY,IAAI,OAAO,cAAc,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,kIAAkI,CAAC,CAAC;QACtJ,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,WAAW,IAAI,OAAO,cAAc,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,iIAAiI,CAAC,CAAC;QACrJ,CAAC;QAED,IAAI,CAAC;YACH,aAAa,CAAC;gBACZ,UAAU,EAAE,IAAI,CAAC,cAA4C,CAAC;gBAC9D,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,oEAAoE,MAAM,CAAC,qBAAqB,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5K,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;QACtC,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,EAAE,GAAG,YAAY,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK;IACnB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC5E,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+interface FirestoreErrorInfo {
+    error: string;
+    code: string | null;
+    tool: string;
+    suggestion: string;
+    details: string | null;
+}
+export declare function formatFirestoreError(error: unknown, toolName: string): FirestoreErrorInfo;
+export {};

package/dist/errors.js

@@ -0,0 +1,62 @@
+const GRPC_CODE_MAP = {
+    1: { name: 'CANCELLED', suggestion: 'The operation was cancelled. Retry the request.' },
+    2: { name: 'UNKNOWN', suggestion: 'An unknown error occurred. Check the details for more information.' },
+    3: { name: 'INVALID_ARGUMENT', suggestion: 'The request contains an invalid argument. Check the path, field names, and filter values.' },
+    4: { name: 'DEADLINE_EXCEEDED', suggestion: 'The request timed out. Try reducing the scope (fewer documents, shallower depth).' },
+    5: { name: 'NOT_FOUND', suggestion: 'The database or project was not found. Verify FIRESTORE_PROJECT_ID and FIRESTORE_DATABASE_ID are correct.' },
+    6: { name: 'ALREADY_EXISTS', suggestion: 'The resource already exists.' },
+    7: { name: 'PERMISSION_DENIED', suggestion: 'The service account lacks read access. Ensure it has the Cloud Datastore Viewer role (roles/datastore.viewer) in the GCP IAM console.' },
+    8: { name: 'RESOURCE_EXHAUSTED', suggestion: 'Quota or rate limit exceeded. Reduce the request scope or wait before retrying.' },
+    9: { name: 'FAILED_PRECONDITION', suggestion: 'This query requires a composite index. The error message above contains a direct link to create it in the Firebase console.' },
+    10: { name: 'ABORTED', suggestion: 'The operation was aborted due to a conflict. Retry the request.' },
+    13: { name: 'INTERNAL', suggestion: 'An internal Firestore error occurred. This is usually transient — retry the request.' },
+    14: { name: 'UNAVAILABLE', suggestion: 'Firestore is temporarily unavailable. Retry the request after a short delay.' },
+    16: { name: 'UNAUTHENTICATED', suggestion: 'The service account credentials are invalid or expired. Check that FIRESTORE_SERVICE_ACCOUNT_KEY_PATH points to a valid JSON key file.' },
+};
+function extractGrpcCode(error) {
+    if (typeof error === 'object' && error !== null && 'code' in error) {
+        const code = error.code;
+        if (typeof code === 'number')
+            return code;
+    }
+    return null;
+}
+function extractGrpcCodeName(error) {
+    const code = extractGrpcCode(error);
+    if (code !== null && GRPC_CODE_MAP[code]) {
+        return GRPC_CODE_MAP[code].name;
+    }
+    if (typeof error === 'object' && error !== null && 'code' in error) {
+        const code = error.code;
+        if (typeof code === 'string')
+            return code;
+    }
+    return null;
+}
+export function formatFirestoreError(error, toolName) {
+    const message = error instanceof Error ? error.message : String(error);
+    const grpcCode = extractGrpcCode(error);
+    const codeName = extractGrpcCodeName(error);
+    let suggestion = 'Check the error message for details. If this persists, verify your service account permissions and Firestore configuration.';
+    if (grpcCode !== null && GRPC_CODE_MAP[grpcCode]) {
+        suggestion = GRPC_CODE_MAP[grpcCode].suggestion;
+    }
+    let details = null;
+    if (error instanceof Error && error.stack) {
+        details = error.stack;
+    }
+    if (typeof error === 'object' && error !== null && 'details' in error) {
+        const d = error.details;
+        if (typeof d === 'string') {
+            details = d;
+        }
+    }
+    return {
+        error: message,
+        code: codeName,
+        tool: toolName,
+        suggestion,
+        details,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+import { loadConfig } from './config.js';
+import { initDb } from './db.js';
+import { registerGetDocument } from './tools/get-document.js';
+import { registerGetCollection } from './tools/get-collection.js';
+import { registerQueryCollection } from './tools/query-collection.js';
+import { registerCollectionGroupQuery } from './tools/collection-group-query.js';
+import { registerListSubcollections } from './tools/list-subcollections.js';
+import { registerCountDocuments } from './tools/count-documents.js';
+import { registerListIndexes } from './tools/list-indexes.js';
+import { registerDumpNode } from './tools/dump-node.js';
+import { registerDumpDatabase } from './tools/dump-database.js';
+import { registerGetServerInfo } from './tools/get-server-info.js';
+import { registerReadCollectionOrdered } from './tools/read-collection-ordered.js';
+let config;
+try {
+    config = loadConfig();
+}
+catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(JSON.stringify({
+        error: `Configuration error: ${message}`,
+        suggestion: 'Check that FIRESTORE_SERVICE_ACCOUNT_KEY_PATH and FIRESTORE_PROJECT_ID environment variables are set correctly in your MCP config.',
+    }, null, 2) + '\n');
+    process.exit(1);
+}
+try {
+    initDb(config);
+}
+catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(JSON.stringify({
+        error: `Database initialization error: ${message}`,
+        suggestion: 'Verify the service account key file is valid and the project ID matches your GCP project.',
+    }, null, 2) + '\n');
+    process.exit(1);
+}
+const server = new McpServer({
+    name: 'firestore-mcp-readonly',
+    version,
+});
+registerGetDocument(server);
+registerGetCollection(server, config);
+registerQueryCollection(server);
+registerCollectionGroupQuery(server);
+registerListSubcollections(server);
+registerCountDocuments(server);
+registerListIndexes(server, config);
+registerDumpNode(server, config);
+registerDumpDatabase(server, config);
+registerGetServerInfo(server, config);
+registerReadCollectionOrdered(server, config);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/limiter.d.ts

@@ -0,0 +1,12 @@
+export declare class LimitExceededError extends Error {
+    constructor(message: string);
+}
+export declare class DumpLimiter {
+    private readonly maxTotal;
+    private readonly maxDepth;
+    private totalDocs;
+    constructor(maxTotal: number, maxDepth: number);
+    checkDepth(depth: number): void;
+    addDocs(count: number): void;
+    get docsProcessed(): number;
+}

package/dist/limiter.js

@@ -0,0 +1,30 @@
+export class LimitExceededError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LimitExceededError';
+    }
+}
+export class DumpLimiter {
+    maxTotal;
+    maxDepth;
+    totalDocs = 0;
+    constructor(maxTotal, maxDepth) {
+        this.maxTotal = maxTotal;
+        this.maxDepth = maxDepth;
+    }
+    checkDepth(depth) {
+        if (depth > this.maxDepth) {
+            throw new LimitExceededError(`Max recursion depth ${this.maxDepth} exceeded`);
+        }
+    }
+    addDocs(count) {
+        this.totalDocs += count;
+        if (this.totalDocs > this.maxTotal) {
+            throw new LimitExceededError(`Max total document count ${this.maxTotal} exceeded — dump truncated`);
+        }
+    }
+    get docsProcessed() {
+        return this.totalDocs;
+    }
+}
+//# sourceMappingURL=limiter.js.map

package/dist/limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiter.js","sourceRoot":"","sources":["../src/limiter.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IAIH;IACA;IAJX,SAAS,GAAG,CAAC,CAAC;IAEtB,YACmB,QAAgB,EAChB,QAAgB;QADhB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;IAChC,CAAC;IAEJ,UAAU,CAAC,KAAa;QACtB,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,IAAI,CAAC,QAAQ,WAAW,CAChD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,IAAI,CAAC,QAAQ,4BAA4B,CACtE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/serializer.d.ts

@@ -0,0 +1,18 @@
+export type SerializedValue = {
+    _type: 'timestamp';
+    value: string;
+} | {
+    _type: 'geopoint';
+    lat: number;
+    lng: number;
+} | {
+    _type: 'reference';
+    path: string;
+} | {
+    _type: 'bytes';
+    base64: string;
+} | null | boolean | number | string | SerializedValue[] | {
+    [key: string]: SerializedValue;
+};
+export declare function serializeValue(value: unknown): SerializedValue;
+export declare function serializeDocument(id: string, path: string, data: Record<string, unknown>): Record<string, SerializedValue>;

package/dist/serializer.js

@@ -0,0 +1,39 @@
+import { Timestamp, GeoPoint, DocumentReference } from 'firebase-admin/firestore';
+export function serializeValue(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (value instanceof Timestamp) {
+        return { _type: 'timestamp', value: value.toDate().toISOString() };
+    }
+    if (value instanceof GeoPoint) {
+        return { _type: 'geopoint', lat: value.latitude, lng: value.longitude };
+    }
+    if (value instanceof DocumentReference) {
+        return { _type: 'reference', path: value.path };
+    }
+    if (Buffer.isBuffer(value) || value instanceof Uint8Array) {
+        return { _type: 'bytes', base64: Buffer.from(value).toString('base64') };
+    }
+    if (Array.isArray(value)) {
+        return value.map(serializeValue);
+    }
+    if (typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = serializeValue(v);
+        }
+        return out;
+    }
+    return value;
+}
+export function serializeDocument(id, path, data) {
+    const out = {
+        _id: id,
+        _path: path,
+    };
+    for (const [k, v] of Object.entries(data)) {
+        out[k] = serializeValue(v);
+    }
+    return out;
+}
+//# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAclF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEvD,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAC1D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAoC,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,KAAkC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,EAAU,EACV,IAAY,EACZ,IAA6B;IAE7B,MAAM,GAAG,GAAoC;QAC3C,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

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

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

@@ -0,0 +1,80 @@
+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'),
+});
+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 registerCollectionGroupQuery(server) {
+    server.tool('firestore_collection_group_query', 'Query across ALL collections with the same ID, regardless of their location in the document hierarchy. For example, querying collectionId "comments" will match /posts/p1/comments, /users/u1/comments, etc. Requires a collection group index.', {
+        collectionId: z.string().describe('Collection ID (not a full path) — e.g. "comments" matches all /*/comments/* documents'),
+        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'),
+    }, async ({ collectionId, where: whereClauses, orderBy: orderByClauses, limit, offset }) => {
+        try {
+            const db = getDb();
+            let query = db.collectionGroup(collectionId);
+            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 (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({
+                            collectionId,
+                            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_collection_group_query'), null, 2),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=collection-group-query.js.map

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

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

package/dist/tools/count-documents.d.ts

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