refactor(@angular/cli): improve discoverability of mcp server options

Author: cexbrayat

packages/angular/cli/src/commands/mcp/cli.ts

@@ -10,7 +10,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { Argv } from 'yargs';
 import { CommandModule, CommandModuleImplementation } from '../../command-builder/command-module';
 import { isTTY } from '../../utilities/tty';
-import { createMcpServer } from './mcp-server';
+import { EXPERIMENTAL_TOOLS, createMcpServer } from './mcp-server';
 
 const INTERACTIVE_MESSAGE = `
 To start using the Angular CLI MCP Server, add this configuration to your host:
@@ -25,6 +25,11 @@ To start using the Angular CLI MCP Server, add this configuration to your host:
 }
 
 Exact configuration may differ depending on the host.
+
+The MCP server accepts several command line options:
+  --read-only: Only register read-only tools.
+  --local-only: Only register tools that do not require internet access.
+  --experimental-tool: Enable an experimental tool. Possible values are: ${EXPERIMENTAL_TOOLS.map((t) => t.name).join(', ')}.
 `;
 
 export default class McpCommandModule extends CommandModule implements CommandModuleImplementation {
@@ -48,7 +53,7 @@ export default class McpCommandModule extends CommandModule implements CommandMo
         type: 'string',
         alias: 'E',
         array: true,
-        describe: 'Enable an experimental tool.',
+        describe: `Enable an experimental tool. Possible values are: ${EXPERIMENTAL_TOOLS.map((t) => t.name).join(', ')}`,
       });
   }
 

packages/angular/cli/src/commands/mcp/mcp-server.ts

@@ -28,7 +28,7 @@ const STABLE_TOOLS = [BEST_PRACTICES_TOOL, DOC_SEARCH_TOOL, LIST_PROJECTS_TOOL]
  * The set of tools that are available but not enabled by default.
  * These tools are considered experimental and may have limitations.
  */
-const EXPERIMENTAL_TOOLS = [FIND_EXAMPLE_TOOL, MODERNIZE_TOOL] as const;
+export const EXPERIMENTAL_TOOLS = [FIND_EXAMPLE_TOOL, MODERNIZE_TOOL] as const;
 
 export async function createMcpServer(
   options: {
@@ -110,6 +110,9 @@ export function assembleToolDeclarations(
         toolDeclarations.push(tool);
       } else {
         options.logger.warn(`Unknown experimental tool: ${toolName}`);
+        options.logger.warn(
+          `Available tools are: ${Array.from(experimentalToolsMap.keys()).join(', ')}`,
+        );
       }
     }
   }