[MCP] Create list_projects tool + slight modifications to list_apps #2 (firebase#8610)

Author: TrCaM

src/mcp/tools/core/index.ts

@@ -10,12 +10,14 @@ import { create_android_sha } from "./create_android_sha.js";
 import { init } from "./init.js";
 import { get_environment } from "./get_environment.js";
 import { update_environment } from "./update_environment.js";
+import { list_projects } from "./list_projects.js";
 // import { consult_assistant } from "./consult_assistant.js";
 
 export const coreTools: ServerTool[] = [
   get_project,
   list_apps,
   get_admin_sdk_config,
+  list_projects,
   get_sdk_config,
   create_project,
   create_app,

src/mcp/tools/core/list_apps.ts

@@ -9,8 +9,8 @@ export const list_apps = tool(
     description: "Retrieves apps registered in the current Firebase project.",
     inputSchema: z.object({
       platform: z
-        .enum(["ios", "android", "web"])
-        .optional()
+        .enum(["ios", "android", "web", "all"])
+        .default("all")
         .describe("the specific platform to list (omit to list all platforms)"),
     }),
     annotations: {
@@ -23,10 +23,15 @@ export const list_apps = tool(
     },
   },
   async ({ platform }, { projectId }) => {
-    const apps = await listFirebaseApps(
-      projectId,
-      (platform?.toUpperCase() as AppPlatform) ?? AppPlatform.ANY,
-    );
-    return toContent(apps);
+    try {
+      const apps = await listFirebaseApps(
+        projectId!,
+        platform === "all" ? AppPlatform.ANY : (platform.toUpperCase() as AppPlatform),
+      );
+      return toContent(apps);
+    } catch (err: any) {
+      const originalMessage = err.original ? `: ${err.original.message}` : "";
+      throw new Error(`Failed to list Firebase apps${originalMessage}`);
+    }
   },
 );

src/mcp/tools/core/list_projects.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { tool } from "../../tool.js";
+import { toContent } from "../../util.js";
+import { getFirebaseProjectPage } from "../../../management/projects.js";
+
+const PROJECT_LIST_PAGE_SIZE = 20;
+
+export const list_projects = tool(
+  {
+    name: "list_projects",
+    description: "Retrieves a list of Firebase projects up to the specified total count.",
+    inputSchema: z.object({
+      page_size: z
+        .number()
+        .min(1)
+        .default(PROJECT_LIST_PAGE_SIZE)
+        .describe("the number of projects to list per page (defaults to 1000)"),
+      page_token: z.string().optional().describe("the page token to start listing from"),
+    }),
+    annotations: {
+      title: "List Firebase Projects",
+      readOnlyHint: true,
+      idempotentHint: true,
+    },
+    _meta: {
+      requiresAuth: true,
+    },
+  },
+  async ({ page_size, page_token }) => {
+    try {
+      const projectPage = await getFirebaseProjectPage(page_size, page_token);
+
+      return toContent(
+        {
+          projects: projectPage.projects,
+          next_page_token: projectPage.nextPageToken,
+        },
+        {
+          contentPrefix: `Here are ${projectPage.projects.length} Firebase projects${page_token ? " (continued)" : ""}:\n\n`,
+          contentSuffix: projectPage.nextPageToken
+            ? "\nThere are more projects available. To see the next page, call this tool again with the next_page_token shown above."
+            : "",
+        },
+      );
+    } catch (err: any) {
+      const originalMessage = err.original ? `: ${err.original.message}` : "";
+      throw new Error(`Failed to list Firebase projects${originalMessage}`);
+    }
+  },
+);