firebase-tools 14.2.1 → 14.2.2

package/lib/init/features/dataconnect/sdk.js

@@ -78,19 +78,21 @@ async function askQuestions(setup, config) {
     const newConnectorYaml = await generateSdkYaml(targetPlatform, connectorYaml, connectorInfo.directory, appDir);
     if (targetPlatform === types_1.Platform.WEB) {
         const unusedFrameworks = fileUtils_1.SUPPORTED_FRAMEWORKS.filter((framework) => { var _a; return !((_a = newConnectorYaml.generate) === null || _a === void 0 ? void 0 : _a.javascriptSdk[framework]); });
-        const hasFrameworkEnabled = unusedFrameworks.length < fileUtils_1.SUPPORTED_FRAMEWORKS.length;
         if (unusedFrameworks.length > 0) {
             const additionalFrameworks = await (0, prompt_1.prompt)(setup, [
                 {
                     type: "checkbox",
                     name: "fdcFrameworks",
-                    message: `Which ${hasFrameworkEnabled ? "additional " : ""}frameworks would you like to generate SDKs for? ` +
+                    message: `Which frameworks would you like to generate SDKs for? ` +
                         "Press Space to select features, then Enter to confirm your choices.",
-                    choices: unusedFrameworks.map((frameworkStr) => ({
-                        value: frameworkStr,
-                        name: frameworkStr,
-                        checked: false,
-                    })),
+                    choices: fileUtils_1.SUPPORTED_FRAMEWORKS.map((frameworkStr) => {
+                        var _a, _b;
+                        return ({
+                            value: frameworkStr,
+                            name: frameworkStr,
+                            checked: (_b = (_a = newConnectorYaml === null || newConnectorYaml === void 0 ? void 0 : newConnectorYaml.generate) === null || _a === void 0 ? void 0 : _a.javascriptSdk) === null || _b === void 0 ? void 0 : _b[frameworkStr],
+                        });
+                    }),
                 },
             ]);
             for (const framework of additionalFrameworks.fdcFrameworks) {

package/lib/logger.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = exports.vsceLogEmitter = void 0;
+exports.silenceStdout = exports.logger = exports.vsceLogEmitter = void 0;
 const winston = require("winston");
 const vsCodeUtils_1 = require("./vsCodeUtils");
 const events_1 = require("events");
@@ -46,6 +46,15 @@ function maybeUseVSCodeLogger(logger) {
     return logger;
 }
 const rawLogger = winston.createLogger();
-rawLogger.add(new winston.transports.Console({ silent: true }));
+rawLogger.add(new winston.transports.Console({
+    silent: true,
+    consoleWarnLevels: ["debug", "warn"],
+}));
 rawLogger.exitOnError = false;
 exports.logger = maybeUseVSCodeLogger(annotateDebugLines(expandErrors(rawLogger)));
+function silenceStdout() {
+    exports.logger = winston.createLogger({
+        silent: true,
+    });
+}
+exports.silenceStdout = silenceStdout;

package/lib/mcp/errors.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpAuthError = exports.NO_PROJECT_ERROR = void 0;
+const util_1 = require("./util");
+exports.NO_PROJECT_ERROR = (0, util_1.mcpError)('No active project was found. Use the `set_firebase_directory` tool to set the project directory to an absolute folder location containing a firebase.json config file. Alternatively, change the MCP server config to add [...,"--dir","/absolute/path/to/project/directory"] in its command-line arguments.', "PRECONDITION_FAILED");
+function mcpAuthError() {
+    const cmd = (0, util_1.commandExistsSync)("firebase") ? "firebase" : "npx -y firebase-tools";
+    return (0, util_1.mcpError)(`The user is not currently logged into the Firebase CLI, which is required to use this tool. Please instruct the user to execute this shell command to sign in or to configure [Application Default Credentials][ADC] on their machine.
+\`\`\`sh
+${cmd} login
+\`\`\`
+
+[ADC]: https://cloud.google.com/docs/authentication/application-default-credentials`);
+}
+exports.mcpAuthError = mcpAuthError;

package/lib/mcp/index.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirebaseMcpServer = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const util_js_1 = require("./util.js");
+const index_js_2 = require("./tools/index.js");
+const configstore_js_1 = require("../configstore.js");
+const index_js_3 = require("./tools/core/index.js");
+const command_js_1 = require("../command.js");
+const requireAuth_js_1 = require("../requireAuth.js");
+const projectUtils_js_1 = require("../projectUtils.js");
+const errors_js_1 = require("./errors.js");
+const SERVER_VERSION = "0.0.1";
+const PROJECT_ROOT_KEY = "mcp.projectRoot";
+const cmd = new command_js_1.Command("experimental:mcp").before(requireAuth_js_1.requireAuth);
+class FirebaseMcpServer {
+    constructor(options) {
+        var _a, _b, _c;
+        this.activeFeatures = options.activeFeatures;
+        this.server = new index_js_1.Server({ name: "firebase", version: SERVER_VERSION });
+        this.server.registerCapabilities({ tools: { listChanged: true } });
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, this.mcpListTools.bind(this));
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, this.mcpCallTool.bind(this));
+        this.projectRoot =
+            (_c = (_b = (_a = options.projectRoot) !== null && _a !== void 0 ? _a : configstore_js_1.configstore.get(PROJECT_ROOT_KEY)) !== null && _b !== void 0 ? _b : process.env.PROJECT_ROOT) !== null && _c !== void 0 ? _c : process.cwd();
+        if (options.projectRoot)
+            this.fixedRoot = true;
+    }
+    get availableTools() {
+        var _a;
+        const toolDefs = this.fixedRoot ? [] : [...index_js_3.coreTools];
+        const activeFeatures = ((_a = this.activeFeatures) === null || _a === void 0 ? void 0 : _a.length)
+            ? this.activeFeatures
+            : Object.keys(index_js_2.tools);
+        for (const key of activeFeatures || []) {
+            toolDefs.push(...index_js_2.tools[key]);
+        }
+        return toolDefs;
+    }
+    getTool(name) {
+        return this.availableTools.find((t) => t.mcp.name === name) || null;
+    }
+    async mcpListTools() {
+        const hasActiveProject = !!(await this.getProjectId());
+        return {
+            tools: this.availableTools.map((t) => t.mcp),
+            _meta: {
+                projectRoot: this.projectRoot,
+                projectDetected: hasActiveProject,
+                authenticated: await this.getAuthenticated(),
+                activeFeatures: this.activeFeatures,
+            },
+        };
+    }
+    setProjectRoot(newRoot) {
+        if (newRoot === null) {
+            configstore_js_1.configstore.delete(PROJECT_ROOT_KEY);
+            this.projectRoot = process.env.PROJECT_ROOT || process.cwd();
+            void this.server.sendToolListChanged();
+            return;
+        }
+        configstore_js_1.configstore.set(PROJECT_ROOT_KEY, newRoot);
+        this.projectRoot = newRoot;
+        void this.server.sendToolListChanged();
+    }
+    async resolveOptions() {
+        const options = { cwd: this.projectRoot };
+        await cmd.prepare(options);
+        return options;
+    }
+    async getProjectId() {
+        return (0, projectUtils_js_1.getProjectId)(await this.resolveOptions());
+    }
+    async getAuthenticated() {
+        try {
+            await (0, requireAuth_js_1.requireAuth)(await this.resolveOptions());
+            return true;
+        }
+        catch (e) {
+            return false;
+        }
+    }
+    async mcpCallTool(request) {
+        var _a, _b;
+        const toolName = request.params.name;
+        const toolArgs = request.params.arguments;
+        const tool = this.getTool(toolName);
+        if (!tool)
+            throw new Error(`Tool '${toolName}' could not be found.`);
+        const projectId = await this.getProjectId();
+        if (((_a = tool.mcp._meta) === null || _a === void 0 ? void 0 : _a.requiresAuth) && !(await this.getAuthenticated()))
+            return (0, errors_js_1.mcpAuthError)();
+        if (((_b = tool.mcp._meta) === null || _b === void 0 ? void 0 : _b.requiresProject) && !projectId)
+            return errors_js_1.NO_PROJECT_ERROR;
+        try {
+            return tool.fn(toolArgs, { projectId: await this.getProjectId(), host: this });
+        }
+        catch (err) {
+            return (0, util_js_1.mcpError)(err);
+        }
+    }
+    async start() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+    }
+}
+exports.FirebaseMcpServer = FirebaseMcpServer;

package/lib/mcp/tool.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tool = void 0;
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+function tool(options, fn) {
+    return {
+        mcp: Object.assign(Object.assign({}, options), { inputSchema: (0, zod_to_json_schema_1.zodToJsonSchema)(options.inputSchema) }),
+        fn,
+    };
+}
+exports.tool = tool;

package/lib/mcp/tools/auth/disable_auth_user.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disable_auth_user = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const auth_js_1 = require("../../../gcp/auth.js");
+exports.disable_auth_user = (0, tool_js_1.tool)({
+    name: "disable_auth_user",
+    description: "Disables or enables a user based on a UID.",
+    inputSchema: zod_1.z.object({
+        uid: zod_1.z.string().describe("The localId or UID of the user to disable or enable"),
+        disabled: zod_1.z.boolean().describe("true disables the user, false enables the user"),
+    }),
+    annotations: {
+        title: "Disable or enable a particular user",
+        destructiveHint: true,
+        idempotentHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async ({ uid, disabled }, { projectId }) => {
+    const res = await (0, auth_js_1.disableUser)(projectId, uid, disabled);
+    if (res) {
+        return (0, util_js_1.toContent)(`User ${uid} as been ${disabled ? "disabled" : "enabled"}`);
+    }
+    return (0, util_js_1.toContent)(`Failed to ${disabled ? "disable" : "enable"} user ${uid}`);
+});

package/lib/mcp/tools/auth/get_auth_user.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_auth_user = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const auth_js_1 = require("../../../gcp/auth.js");
+exports.get_auth_user = (0, tool_js_1.tool)({
+    name: "get_auth_user",
+    description: "Retrieves a user based on an email address, phone number, or UID.",
+    inputSchema: zod_1.z.object({
+        email: zod_1.z.string().optional(),
+        phoneNumber: zod_1.z.string().optional(),
+        uid: zod_1.z.string().optional(),
+    }),
+    annotations: {
+        title: "Get information about 1 user.",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async ({ email, phoneNumber, uid }, { projectId }) => {
+    if (email === undefined && phoneNumber === undefined && uid === undefined) {
+        return (0, util_js_1.mcpError)(`No user identifier supplied in get_auth_user tool`);
+    }
+    return (0, util_js_1.toContent)(await (0, auth_js_1.findUser)(projectId, email, phoneNumber, uid));
+});

package/lib/mcp/tools/auth/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.authTools = void 0;
+const get_auth_user_js_1 = require("./get_auth_user.js");
+const disable_auth_user_js_1 = require("./disable_auth_user.js");
+const set_auth_claims_js_1 = require("./set_auth_claims.js");
+exports.authTools = [get_auth_user_js_1.get_auth_user, disable_auth_user_js_1.disable_auth_user, set_auth_claims_js_1.set_auth_claim];

package/lib/mcp/tools/auth/set_auth_claims.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.set_auth_claim = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const auth_js_1 = require("../../../gcp/auth.js");
+exports.set_auth_claim = (0, tool_js_1.tool)({
+    name: "set_auth_claims",
+    description: "Sets custom claims on a specific user's account. Use to create trusted values associated with a user e.g. marking them as an admin. Claims are limited in size and should be succinct in name and value.",
+    inputSchema: zod_1.z.object({
+        uid: zod_1.z.string().describe("the UID of the user to update"),
+        claim: zod_1.z.string().describe("the name (key) of the claim to update, e.g. 'admin'"),
+        value: zod_1.z
+            .union([
+            zod_1.z.string(),
+            zod_1.z.number(),
+            zod_1.z.boolean(),
+            zod_1.z.record(zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean()])),
+            zod_1.z.array(zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean()])),
+        ])
+            .describe("the value of the custom claim"),
+    }),
+    annotations: {
+        title: "Set custom Firebase Auth claim",
+        idempotentHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async ({ uid, claim, value }, { projectId }) => {
+    return (0, util_js_1.toContent)(await (0, auth_js_1.setCustomClaim)(projectId, uid, { [claim]: value }, { merge: true }));
+});

package/lib/mcp/tools/core/get_firebase_directory.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_firebase_directory = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const detectProjectRoot_js_1 = require("../../../detectProjectRoot.js");
+exports.get_firebase_directory = (0, tool_js_1.tool)({
+    name: "get_firebase_directory",
+    description: "Gets the current Firebase project directory. If this has been set using the `set_firebase_directory` tool it will return that, otherwise it will look for a PROJECT_ROOT environment variable or the current working directory of the running Firebase MCP server.",
+    inputSchema: zod_1.z.object({}),
+    annotations: {
+        title: "Get Firebase Project Directory",
+        readOnlyHint: true,
+    },
+}, (_, { host }) => {
+    if (!(0, detectProjectRoot_js_1.detectProjectRoot)({ cwd: host.projectRoot }))
+        return Promise.resolve((0, util_js_1.mcpError)(`There is no detected 'firebase.json' in directory '${host.projectRoot}'. Please use the 'set_firebase_directory' tool to activate a Firebase project directory.`));
+    return Promise.resolve((0, util_js_1.toContent)(`The current Firebase project directory is '${host.projectRoot}'.`));
+});

package/lib/mcp/tools/core/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coreTools = void 0;
+const get_firebase_directory_1 = require("./get_firebase_directory");
+const set_firebase_directory_1 = require("./set_firebase_directory");
+exports.coreTools = [get_firebase_directory_1.get_firebase_directory, set_firebase_directory_1.set_firebase_directory];

package/lib/mcp/tools/core/set_firebase_directory.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.set_firebase_directory = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const fs_1 = require("fs");
+const path_1 = require("path");
+exports.set_firebase_directory = (0, tool_js_1.tool)({
+    name: "set_firebase_directory",
+    description: "Sets the project directory for the Firebase MCP server to utilize for project detection and authentication. This should be a directory with a `firebase.json` file in it. This information is persisted between sessions.",
+    inputSchema: zod_1.z.object({
+        dir: zod_1.z
+            .string()
+            .nullable()
+            .describe("the absolute path of the directory. set to null to 'unset' the value and fall back to the working directory"),
+    }),
+    annotations: {
+        title: "Set Firebase Project Directory",
+        idempotentHint: true,
+    },
+}, ({ dir }, { host }) => {
+    if (dir === null) {
+        host.setProjectRoot(null);
+        return Promise.resolve((0, util_js_1.toContent)(`Firebase MCP project directory setting deleted. New project root is: ${host.projectRoot || "unset"}`));
+    }
+    if (!(0, fs_1.existsSync)(dir))
+        return Promise.resolve((0, util_js_1.mcpError)(`Directory '${dir}' does not exist.`));
+    if (!(0, fs_1.existsSync)((0, path_1.join)(dir, "firebase.json")))
+        return Promise.resolve((0, util_js_1.mcpError)(`Directory '${dir}' does not contain a 'firebase.json' file.`));
+    host.setProjectRoot(dir);
+    return Promise.resolve((0, util_js_1.toContent)(`Firebase MCP project directory set to '${dir}'.`));
+});

package/lib/mcp/tools/dataconnect/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataconnectTools = void 0;
+const list_dataconnect_services_js_1 = require("./list_dataconnect_services.js");
+exports.dataconnectTools = [list_dataconnect_services_js_1.list_dataconnect_services];

package/lib/mcp/tools/dataconnect/list_dataconnect_services.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.list_dataconnect_services = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const client = require("../../../dataconnect/client");
+exports.list_dataconnect_services = (0, tool_js_1.tool)({
+    name: "list_dataconnect_services",
+    description: "List the Firebase Data Connect services available in the current project.",
+    inputSchema: zod_1.z.object({}),
+    annotations: {
+        title: "List the Firebase Data Connect Services that's available in the backend",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async (_, { projectId }) => {
+    const services = await client.listAllServices(projectId);
+    return (0, util_js_1.toContent)(services, { format: "yaml" });
+});

package/lib/mcp/tools/firestore/converter.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firestoreDocumentToJson = void 0;
+const logger_1 = require("../../../logger");
+function firestoreValueToJson(firestoreValue) {
+    var _a, _b;
+    if ("nullValue" in firestoreValue)
+        return null;
+    if ("booleanValue" in firestoreValue)
+        return firestoreValue.booleanValue;
+    if ("integerValue" in firestoreValue) {
+        const num = Number(firestoreValue.integerValue);
+        if (num > Number.MAX_SAFE_INTEGER || num < Number.MIN_SAFE_INTEGER) {
+            return firestoreValue.integerValue;
+        }
+        return num;
+    }
+    if ("doubleValue" in firestoreValue)
+        return firestoreValue.doubleValue;
+    if ("timestampValue" in firestoreValue)
+        return { __type__: "Timestamp", value: firestoreValue.timestampValue };
+    if ("stringValue" in firestoreValue)
+        return firestoreValue.stringValue;
+    if ("bytesValue" in firestoreValue)
+        return firestoreValue.bytesValue;
+    if ("referenceValue" in firestoreValue)
+        return { __type__: "Reference", value: firestoreValue.referenceValue };
+    if ("geoPointValue" in firestoreValue)
+        return {
+            __type__: "GeoPoint",
+            value: [firestoreValue.geoPointValue.latitude, firestoreValue.geoPointValue.longitude],
+        };
+    if ("arrayValue" in firestoreValue)
+        return (_b = (_a = firestoreValue.arrayValue.values) === null || _a === void 0 ? void 0 : _a.map((v) => firestoreValueToJson(v))) !== null && _b !== void 0 ? _b : [];
+    if ("mapValue" in firestoreValue) {
+        const map = firestoreValue.mapValue.fields || {};
+        const obj = {};
+        for (const key of Object.keys(map)) {
+            obj[key] = firestoreValueToJson(map[key]);
+        }
+        return obj;
+    }
+    logger_1.logger.warn("Unhandled Firestore Value type encountered:", firestoreValue);
+    return undefined;
+}
+function firestoreDocumentToJson(firestoreDoc) {
+    const nameParts = firestoreDoc.name.split("/documents/");
+    const path = nameParts.length > 1 ? nameParts[nameParts.length - 1] : "";
+    const result = { __path__: path };
+    if (firestoreDoc.fields) {
+        for (const key of Object.keys(firestoreDoc.fields)) {
+            result[key] = firestoreValueToJson(firestoreDoc.fields[key]);
+        }
+    }
+    return result;
+}
+exports.firestoreDocumentToJson = firestoreDocumentToJson;

package/lib/mcp/tools/firestore/get_documents.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_documents = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const firestore_js_1 = require("../../../gcp/firestore.js");
+const converter_js_1 = require("./converter.js");
+exports.get_documents = (0, tool_js_1.tool)({
+    name: "get_documents",
+    description: "Retrieves one or more Firestore documents from a database in the current project by full document paths. Use this if you know the exact path of a document.",
+    inputSchema: zod_1.z.object({
+        paths: zod_1.z
+            .array(zod_1.z.string())
+            .describe("One or more document paths (e.g. `collectionName/documentId` or `parentCollection/parentDocument/collectionName/documentId`)"),
+    }),
+    annotations: {
+        title: "Get Firestore documents",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async ({ paths }, { projectId }) => {
+    if (!paths.length)
+        return (0, util_js_1.mcpError)("Must supply at least one document path.");
+    const { documents, missing } = await (0, firestore_js_1.getDocuments)(projectId, paths);
+    if (missing.length > 0 && documents.length === 0) {
+        return (0, util_js_1.mcpError)(`None of the specified documents were found in project '${projectId}'`);
+    }
+    const docs = documents.map(converter_js_1.firestoreDocumentToJson);
+    if (documents.length === 1 && missing.length === 0) {
+        return (0, util_js_1.toContent)(docs[0]);
+    }
+    const docsContent = (0, util_js_1.toContent)(docs);
+    if (missing.length) {
+        docsContent.content = [
+            { type: "text", text: "Retrieved documents:\n\n" },
+            ...docsContent.content,
+            {
+                type: "text",
+                text: `The following documents do not exist: ${missing.join(", ")}`,
+            },
+        ];
+    }
+    return docsContent;
+});

package/lib/mcp/tools/firestore/get_firestore_rules.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_firestore_rules = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const rules_1 = require("../../../gcp/rules");
+exports.get_firestore_rules = (0, tool_js_1.tool)({
+    name: "get_firestore_rules",
+    description: "Retrieves the active Firestore security rules for the current project.",
+    inputSchema: zod_1.z.object({}),
+    annotations: {
+        title: "Get Current Firestore Rules",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async (_, { projectId }) => {
+    const rulesetName = await (0, rules_1.getLatestRulesetName)(projectId, "cloud.firestore");
+    if (!rulesetName)
+        return (0, util_js_1.mcpError)(`No active Firestore rules were found in project '${projectId}'`);
+    const rules = await (0, rules_1.getRulesetContent)(rulesetName);
+    return (0, util_js_1.toContent)(rules[0].content);
+});

package/lib/mcp/tools/firestore/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firestoreTools = void 0;
+const get_documents_1 = require("./get_documents");
+const get_firestore_rules_1 = require("./get_firestore_rules");
+const list_collections_1 = require("./list_collections");
+exports.firestoreTools = [list_collections_1.list_collections, get_documents_1.get_documents, get_firestore_rules_1.get_firestore_rules];

package/lib/mcp/tools/firestore/list_collections.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.list_collections = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const firestore_js_1 = require("../../../gcp/firestore.js");
+const errors_js_1 = require("../../errors.js");
+exports.list_collections = (0, tool_js_1.tool)({
+    name: "list_collections",
+    description: "Retrieves a list of collections from a Firestore database in the current project.",
+    inputSchema: zod_1.z.object({
+        document_path: zod_1.z
+            .string()
+            .nullish()
+            .describe("a parent document to list subcollections under. only needed for subcollections, omit to list top-level collections"),
+    }),
+    annotations: {
+        title: "List Firestore collections",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async (_, { projectId }) => {
+    if (!projectId)
+        return errors_js_1.NO_PROJECT_ERROR;
+    return (0, util_js_1.toContent)(await (0, firestore_js_1.listCollectionIds)(projectId));
+});

package/lib/mcp/tools/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tools = void 0;
+const index_js_1 = require("./auth/index.js");
+const index_js_2 = require("./dataconnect/index.js");
+const index_js_3 = require("./firestore/index.js");
+const index_js_4 = require("./project/index.js");
+exports.tools = {
+    project: index_js_4.projectTools,
+    firestore: index_js_3.firestoreTools,
+    auth: index_js_1.authTools,
+    dataconnect: index_js_2.dataconnectTools,
+    storage: [],
+};

package/lib/mcp/tools/project/get_project.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_project = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const projects_js_1 = require("../../../management/projects.js");
+const util_js_1 = require("../../util.js");
+exports.get_project = (0, tool_js_1.tool)({
+    name: "get_project",
+    description: "Retrieves information about the currently active Firebase project.",
+    inputSchema: zod_1.z.object({}),
+    annotations: {
+        title: "Get Current Firebase Project",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresAuth: true,
+        requiresProject: true,
+    },
+}, async (_, { projectId }) => {
+    return (0, util_js_1.toContent)(await (0, projects_js_1.getProject)(projectId));
+});

package/lib/mcp/tools/project/get_sdk_config.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_sdk_config = void 0;
+const zod_1 = require("zod");
+const tool_js_1 = require("../../tool.js");
+const util_js_1 = require("../../util.js");
+const apps_js_1 = require("../../../management/apps.js");
+exports.get_sdk_config = (0, tool_js_1.tool)({
+    name: "get_sdk_config",
+    description: "Retrieves the Firebase SDK configuration information for the specified platform. You must specify either a platform or an app_id.",
+    inputSchema: zod_1.z.object({
+        platform: zod_1.z
+            .enum(["ios", "android", "web"])
+            .nullish()
+            .describe("the platform for which you want config"),
+        app_id: zod_1.z.string().nullish().describe("the specific app id to fetch"),
+    }),
+    annotations: {
+        title: "Get Firebase SDK Config",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async ({ platform: inputPlatform, app_id: appId }, { projectId }) => {
+    var _a, _b;
+    let platform = inputPlatform === null || inputPlatform === void 0 ? void 0 : inputPlatform.toUpperCase();
+    if (!platform && !appId)
+        return (0, util_js_1.mcpError)("Must specify one of 'web', 'ios', or 'android' for platform or an app_id for get_sdk_config tool.");
+    const apps = await (0, apps_js_1.listFirebaseApps)(projectId, platform !== null && platform !== void 0 ? platform : apps_js_1.AppPlatform.ANY);
+    platform = platform || ((_a = apps.find((app) => app.appId === appId)) === null || _a === void 0 ? void 0 : _a.platform);
+    appId = appId || ((_b = apps.find((app) => app.platform === platform)) === null || _b === void 0 ? void 0 : _b.appId);
+    if (!appId)
+        return (0, util_js_1.mcpError)(`Could not find an app for platform '${inputPlatform}' in project '${projectId}'`);
+    const sdkConfig = await (0, apps_js_1.getAppConfig)(appId, platform);
+    return (0, util_js_1.toContent)(sdkConfig, { format: "json" });
+});

package/lib/mcp/tools/project/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectTools = void 0;
+const get_project_js_1 = require("./get_project.js");
+const get_sdk_config_js_1 = require("./get_sdk_config.js");
+const list_apps_js_1 = require("./list_apps.js");
+exports.projectTools = [get_project_js_1.get_project, list_apps_js_1.list_apps, get_sdk_config_js_1.get_sdk_config];