firebase-tools 14.2.0 → 14.2.2

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];

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.list_apps = 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.list_apps = (0, tool_js_1.tool)({
+    name: "list_apps",
+    description: "Retrieves apps registered in the current Firebase project.",
+    inputSchema: zod_1.z.object({
+        platform: zod_1.z
+            .enum(["ios", "android", "web"])
+            .nullish()
+            .describe("the specific platform to list (omit to list all platforms)"),
+    }),
+    annotations: {
+        title: "List Firebase Apps",
+        readOnlyHint: true,
+    },
+    _meta: {
+        requiresProject: true,
+        requiresAuth: true,
+    },
+}, async ({ platform }, { projectId }) => {
+    var _a;
+    const apps = await (0, apps_js_1.listFirebaseApps)(projectId, (_a = platform === null || platform === void 0 ? void 0 : platform.toUpperCase()) !== null && _a !== void 0 ? _a : apps_js_1.AppPlatform.ANY);
+    return (0, util_js_1.toContent)(apps);
+});

package/lib/mcp/types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVER_FEATURES = void 0;
+exports.SERVER_FEATURES = ["project", "firestore", "storage", "dataconnect", "auth"];

package/lib/mcp/util.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandExistsSync = exports.mcpError = exports.toContent = void 0;
+const child_process_1 = require("child_process");
+const js_yaml_1 = require("js-yaml");
+const os_1 = require("os");
+function toContent(data, options) {
+    if (typeof data === "string")
+        return { content: [{ type: "text", text: data }] };
+    let text = "";
+    const format = (options === null || options === void 0 ? void 0 : options.format) || "yaml";
+    switch (format) {
+        case "json":
+            text = JSON.stringify(data);
+            break;
+        case "yaml":
+            text = (0, js_yaml_1.dump)(data);
+            break;
+    }
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+exports.toContent = toContent;
+function mcpError(message, code) {
+    let errorMessage = "unknown error";
+    if (message instanceof Error) {
+        errorMessage = message.message;
+    }
+    if (typeof message === "string") {
+        errorMessage = message;
+    }
+    return {
+        isError: true,
+        content: [{ type: "text", text: `Error: ${code ? `${code}: ` : ""}${errorMessage}` }],
+    };
+}
+exports.mcpError = mcpError;
+function commandExistsSync(command) {
+    try {
+        const isWindows = (0, os_1.platform)() === "win32";
+        const commandToCheck = isWindows
+            ? `where "${command}" > nul 2> nul`
+            : `which "${command}" > /dev/null 2> /dev/null`;
+        (0, child_process_1.execSync)(commandToCheck);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+exports.commandExistsSync = commandExistsSync;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "14.2.0",
+  "version": "14.2.2",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "bin": {
@@ -63,6 +63,7 @@
     "@electric-sql/pglite": "^0.2.16",
     "@google-cloud/cloud-sql-connector": "^1.3.3",
     "@google-cloud/pubsub": "^4.5.0",
+    "@modelcontextprotocol/sdk": "^1.10.2",
     "abort-controller": "^3.0.0",
     "ajv": "^8.17.1",
     "ajv-formats": "3.0.1",
@@ -127,7 +128,9 @@
     "winston": "^3.0.0",
     "winston-transport": "^4.4.0",
     "ws": "^7.5.10",
-    "yaml": "^2.4.1"
+    "yaml": "^2.4.1",
+    "zod": "^3.24.3",
+    "zod-to-json-schema": "^3.24.5"
   },
   "overrides": {
     "@angular-devkit/core": {

package/templates/init/dataconnect/connector.yaml

@@ -12,3 +12,6 @@ connectorId: __connectorId__
 #   kotlinSdk:
 #     outputDir: <Path where you want the generated SDK to be written to, relative to this file>
 #     package: connectors.default
+#   dartSdk:
+#     outputDir: <Path where you want the generated SDK to be written to, relative to this file>
+#     package: default_connector