refactor(@angular/cli): move find_examples to experimental

This change moves the `find_examples` tool to the experimental toolset. It can now be enabled by passing the `--experimental-tool find_examples` flag to the `ng mcp` command.

For backward compatibility, the tool will also be enabled if the `NG_MCP_CODE_EXAMPLES=1` environment variable is set.

Author: clydin

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

@@ -66,16 +66,13 @@ export async function createMcpServer(
     },
   );
 
-  let toolDeclarations = [
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  let toolDeclarations: McpToolDeclaration<any, any>[] = [
     BEST_PRACTICES_TOOL,
     DOC_SEARCH_TOOL,
     LIST_PROJECTS_TOOL,
-    MODERNIZE_TOOL,
-    FIND_EXAMPLE_TOOL,
   ];
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  const experimentalToolDeclarations: McpToolDeclaration<any, any>[] = [];
+  const experimentalToolDeclarations = [FIND_EXAMPLE_TOOL, MODERNIZE_TOOL];
 
   if (context.readOnly) {
     toolDeclarations = toolDeclarations.filter((tool) => tool.isReadOnly);
@@ -85,12 +82,17 @@ export async function createMcpServer(
     toolDeclarations = toolDeclarations.filter((tool) => tool.isLocalOnly);
   }
 
-  if (context.experimentalTools?.length) {
+  const enabledExperimentalTools = new Set(context.experimentalTools);
+  if (process.env['NG_MCP_CODE_EXAMPLES'] === '1') {
+    enabledExperimentalTools.add('find_examples');
+  }
+
+  if (enabledExperimentalTools.size > 0) {
     const experimentalToolsMap = new Map(
       experimentalToolDeclarations.map((tool) => [tool.name, tool]),
     );
 
-    for (const toolName of context.experimentalTools) {
+    for (const toolName of enabledExperimentalTools) {
       const tool = experimentalToolsMap.get(toolName);
       if (tool) {
         toolDeclarations.push(tool);

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

@@ -55,10 +55,6 @@ export const FIND_EXAMPLE_TOOL = declareTool({
   isReadOnly: true,
   isLocalOnly: true,
   shouldRegister: ({ logger }) => {
-    if (process.env['NG_MCP_CODE_EXAMPLES'] !== '1') {
-      return false;
-    }
-
     // sqlite database support requires Node.js 22.16+
     const [nodeMajor, nodeMinor] = process.versions.node.split('.', 2).map(Number);
     if (nodeMajor < 22 || (nodeMajor === 22 && nodeMinor < 16)) {