refactor(@angular/cli): provide additional project details for MCP list projects tool

The Angular CLI's MCP server will now provide additional information regarding
each project when the list projects tool is used. This includes:
* name
* type (application/library)
* root (project root path relative to the Angular workspace root)
* sourceRoot (source code root path relative to the Angular workspace root)
* selectorPrefix (default selector prefix used for component generation)

Author: clydin

packages/angular/cli/BUILD.bazel

@@ -58,6 +58,7 @@ ts_project(
         ":node_modules/pacote",
         ":node_modules/resolve",
         ":node_modules/yargs",
+        ":node_modules/zod",
         "//:node_modules/@angular/core",
         "//:node_modules/@types/ini",
         "//:node_modules/@types/node",

packages/angular/cli/package.json

@@ -38,7 +38,8 @@
     "pacote": "21.0.0",
     "resolve": "1.22.10",
     "semver": "7.7.2",
-    "yargs": "18.0.0"
+    "yargs": "18.0.0",
+    "zod": "3.25.75"
   },
   "ng-update": {
     "migrations": "@schematics/angular/migrations/migration-collection.json",

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

@@ -9,6 +9,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
+import { z } from 'zod';
 import type { AngularWorkspace } from '../../utilities/config';
 import { VERSION } from '../../utilities/version';
 
@@ -30,10 +31,10 @@ export async function createMcpServer(context: {
     {
       title: 'Angular Best Practices and Code Generation Guide',
       description:
-        "A comprehensive guide detailing Angular's best practices for code generation and development. " +
-        'This guide should be used as a reference by an LLM to ensure any generated code ' +
-        'adheres to modern Angular standards, including the use of standalone components, ' +
-        'typed forms, modern control flow syntax, and other current conventions.',
+        "A comprehensive guide detailing Angular's best practices for code generation and development." +
+        ' This guide should be used as a reference by an LLM to ensure any generated code' +
+        ' adheres to modern Angular standards, including the use of standalone components,' +
+        ' typed forms, modern control flow syntax, and other current conventions.',
       mimeType: 'text/markdown',
     },
     async () => {
@@ -56,6 +57,34 @@ export async function createMcpServer(context: {
       annotations: {
         readOnlyHint: true,
       },
+      outputSchema: {
+        projects: z.array(
+          z.object({
+            name: z
+              .string()
+              .describe('The name of the project, as defined in the `angular.json` file.'),
+            type: z
+              .enum(['application', 'library'])
+              .optional()
+              .describe(`The type of the project, either 'application' or 'library'.`),
+            root: z
+              .string()
+              .describe('The root directory of the project, relative to the workspace root.'),
+            sourceRoot: z
+              .string()
+              .describe(
+                `The root directory of the project's source files, relative to the workspace root.`,
+              ),
+            selectorPrefix: z
+              .string()
+              .optional()
+              .describe(
+                'The prefix to use for component selectors.' +
+                  ` For example, a prefix of 'app' would result in selectors like '<app-my-component>'.`,
+              ),
+          }),
+        ),
+      },
     },
     async () => {
       const { workspace } = context;
@@ -74,13 +103,28 @@ export async function createMcpServer(context: {
         };
       }
 
+      const projects = [];
+      // Convert to output format
+      for (const [name, project] of workspace.projects.entries()) {
+        projects.push({
+          name,
+          type: project.extensions['projectType'] as 'application' | 'library' | undefined,
+          root: project.root,
+          sourceRoot: project.sourceRoot ?? path.posix.join(project.root, 'src'),
+          selectorPrefix: project.extensions['prefix'] as string,
+        });
+      }
+
+      // The structuredContent field is newer and may not be supported by all hosts.
+      // A text representation of the content is also provided for compatibility.
       return {
         content: [
           {
             type: 'text' as const,
-            text: 'Projects in the Angular workspace: ' + [...workspace.projects.keys()].join(','),
+            text: `Projects in the Angular workspace:\n${JSON.stringify(projects)}`,
           },
         ],
+        structuredContent: { projects },
       };
     },
   );