feat: Rename experimental:mcp to mcp (#9168)

This commit renames the `experimental:mcp` command to `mcp` and adds an alias for the old name to maintain backward compatibility. All references to the old command name in the codebase have been updated.

Additionally, the `isEnabled('mcp')` check has been removed, as the command is now stable.

A changelog entry has been added for this change.

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Joe Hanley <[email protected]>

Author: google-labs-jules[bot]

CHANGELOG.md

@@ -1,2 +1,3 @@
+- The `experimental:mcp` command has been renamed to `mcp`. The old name is now an alias.
 - `firebase_update_environment` MCP tool supports accepting Gemini in Firebase Terms of Service.
 - Fixed a bug when `firebase init dataconnect` failed to create a React app when launched from VS Code extension (#9171).

scripts/mcp-tests/gemini-smoke-test.ts

@@ -15,7 +15,7 @@ await client.connect(
   new StdioClientTransport({
     command: "../../lib/bin/firebase.js",
     args: [
-      "experimental:mcp",
+      "mcp",
       "--only",
       "firestore,dataconnect,messaging,remoteconfig,crashlytics,auth,storage,apphosting",
     ],

src/bin/firebase.ts

@@ -2,7 +2,6 @@
 
 // Check for older versions of Node no longer supported by the CLI.
 import * as semver from "semver";
-import { isEnabled } from "../experiments";
 const pkg = require("../../package.json");
 const nodeVersion = process.version;
 if (!semver.satisfies(nodeVersion, pkg.engines.node)) {
@@ -13,7 +12,7 @@ if (!semver.satisfies(nodeVersion, pkg.engines.node)) {
 }
 
 // we short-circuit the normal process for MCP
-if (isEnabled("mcp") && process.argv[2] === "experimental:mcp") {
+if (process.argv[2] === "mcp" || process.argv[2] === "experimental:mcp") {
   const { mcp } = require("./mcp");
   mcp();
 } else {

src/bin/mcp.ts

@@ -14,7 +14,7 @@ This is a running process of the Firebase MCP server. This command should only b
   "mcpServers": {
     "firebase": {
       "command": "firebase",
-      "args": ["experimental:mcp", "--dir", "/path/to/firebase/project"]
+      "args": ["mcp", "--dir", "/path/to/firebase/project"]
     }
   }
 }

src/commands/mcp.ts

@@ -1,10 +1,9 @@
 import { Command } from "../command";
 import { requireAuth } from "../requireAuth";
 
-export const command = new Command("experimental:mcp")
-  .description(
-    "Start an MCP server with access to the current working directory's project and resources.",
-  )
+export const command = new Command("mcp")
+  .alias("experimental:mcp")
+  .description("Run the multi-modal conversational platform (MCP) server.")
   .before(requireAuth)
   .action(() => {
     throw new Error("MCP logic is implemented elsewhere, this should never be reached.");

src/init/features/aitools/claude.ts

@@ -41,7 +41,7 @@ export const claude: AIToolModule = {
       }
       existingConfig.mcpServers.firebase = {
         command: "npx",
-        args: ["-y", "firebase-tools", "experimental:mcp", "--dir", projectPath],
+        args: ["-y", "firebase-tools", "mcp", "--dir", projectPath],
       };
       config.writeProjectFile(MCP_CONFIG_PATH, JSON.stringify(existingConfig, null, 2));
       mcpUpdated = true;

src/init/features/aitools/cursor.ts

@@ -61,7 +61,7 @@ export const cursor: AIToolModule = {
       }
       existingMcpConfig.mcpServers.firebase = {
         command: "npx",
-        args: ["-y", "firebase-tools", "experimental:mcp", "--dir", projectPath],
+        args: ["-y", "firebase-tools", "mcp", "--dir", projectPath],
       };
       config.writeProjectFile(CURSOR_MCP_PATH, JSON.stringify(existingMcpConfig, null, 2));
       mcpUpdated = true;

src/mcp/CONTRIBUTING.md

@@ -67,7 +67,7 @@ and manually list and execute tools.
 ```
 Transport Type: STDIO
 Command: firebase
-Arguments: experimental:mcp
+Arguments: mcp
 
 ```
 
@@ -170,7 +170,7 @@ const tools: Record<ServerFeature, ServerTool[]> = {
 Run the following command to add your new tool to the list in `src/mcp/README.md`
 
 ```
-node lib/bin/firebase.js experimental:mcp --generate-tool-list
+node lib/bin/firebase.js mcp --generate-tool-list
 ```
 
 ### Logging and terminal formatting

src/mcp/README.md

@@ -22,7 +22,7 @@ If you are using an MCP client that is configured with a JSON, the following exa
   "mcpServers": {
     "firebase": {
       "command": "npx",
-      "args": ["-y", "firebase-tools", "experimental:mcp", "--dir", "."]
+      "args": ["-y", "firebase-tools", "mcp", "--dir", "."]
     }
   }
 }

src/mcp/index.ts

@@ -46,7 +46,7 @@ import { resources } from "./resources";
 
 const SERVER_VERSION = "0.3.0";
 
-const cmd = new Command("experimental:mcp");
+const cmd = new Command("mcp");
 
 const orderedLogLevels = [
   "debug",