MCP: Add --generate-prompt-list option (#9249)

Author: kevinthecheung

src/bin/mcp.ts

@@ -5,6 +5,7 @@ import { FirebaseMcpServer } from "../mcp/index";
 import { parseArgs } from "util";
 import { SERVER_FEATURES, ServerFeature } from "../mcp/types";
 import { markdownDocsOfTools } from "../mcp/tools/index.js";
+import { markdownDocsOfPrompts } from "../mcp/prompts/index.js";
 import { resolve } from "path";
 
 const STARTUP_MESSAGE = `
@@ -26,13 +27,22 @@ export async function mcp(): Promise<void> {
       only: { type: "string", default: "" },
       dir: { type: "string" },
       "generate-tool-list": { type: "boolean", default: false },
+      "generate-prompt-list": { type: "boolean", default: false },
     },
     allowPositionals: true,
   });
+
+  let earlyExit = false;
   if (values["generate-tool-list"]) {
     console.log(markdownDocsOfTools());
-    return;
+    earlyExit = true;
+  }
+  if (values["generate-prompt-list"]) {
+    console.log(markdownDocsOfPrompts());
+    earlyExit = true;
   }
+  if (earlyExit) return;
+
   process.env.IS_FIREBASE_MCP = "true";
   useFileLogger();
   const activeFeatures = (values.only || "")

src/mcp/README.md

@@ -69,3 +69,10 @@ Only counts events matching the given filters. |
 | apphosting_list_backends | apphosting | Use this to retrieve a list of App Hosting backends in the current project. An empty list means that there are no backends. The `uri` is the public URL of the backend. A working backend will have a `managed_resources` array that will contain a `run_service` entry. That `run_service.service` is the resource name of the Cloud Run service serving the App Hosting backend. The last segment of that name is the service ID. `domains` is the list of domains that are associated with the backend. They either have type `CUSTOM` or `DEFAULT`. Every backend should have a `DEFAULT` domain. The actual domain that a user would use to conenct to the backend is the last parameter of the domain resource name. If a custom domain is correctly set up, it will have statuses ending in `ACTIVE`. |
 | realtimedatabase_get_data | realtimedatabase | Use this to retrieve data from the specified location in a Firebase Realtime Database. |
 | realtimedatabase_set_data | realtimedatabase | Use this to write data to the specified location in a Firebase Realtime Database. |
+
+| Prompt Name         | Feature Group | Description                                                                                                                                                                                                              |
+| ------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| firebase:deploy     | core          | Use this command to deploy resources to Firebase. <br><br>Arguments: <br>&lt;prompt&gt; (optional): any specific instructions you wish to provide about deploying                                                        |
+| firebase:init       | core          | Use this command to setup Firebase for the current workspace.                                                                                                                                                            |
+| firebase:consult    | core          | Use this command to consult the Firebase Assistant with access to detailed up-to-date documentation for the Firebase platform. <br><br>Arguments: <br>&lt;prompt&gt;: a question to pass to the Gemini in Firebase model |
+| crashlytics:connect | crashlytics   | Access a Firebase application's Crashlytics data.                                                                                                                                                                        |

src/mcp/prompts/index.ts

@@ -54,3 +54,28 @@ export function availablePrompts(features?: ServerFeature[]): ServerPrompt[] {
   }
   return allPrompts;
 }
+
+/**
+ * Generates a markdown table of all available prompts and their descriptions.
+ * This is used for generating documentation.
+ */
+export function markdownDocsOfPrompts(): string {
+  const allPrompts = availablePrompts();
+  let doc = `
+| Prompt Name | Feature Group | Description |
+| ----------- | ------------- | ----------- |`;
+  for (const prompt of allPrompts) {
+    const feature = prompt.mcp._meta?.feature || "";
+    let description = prompt.mcp.description || "";
+    if (prompt.mcp.arguments?.length) {
+      const argsList = prompt.mcp.arguments.map(
+        (arg) =>
+          ` <br>&lt;${arg.name}&gt;${arg.required ? "" : " (optional)"}: ${arg.description || ""}`,
+      );
+      description += ` <br><br>Arguments:${argsList.join("")}`;
+    }
+    doc += `
+| ${prompt.mcp.name} | ${feature} | ${description} |`;
+  }
+  return doc;
+}