refactor(@angular/cli): expand MCP tool/resource descriptions

The descriptions for both the initial best practices resource and list
projects tool have been expanded to provide more context regarding their
use and results.

(cherry picked from commit e23730a)

Author: clydin

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

@@ -28,9 +28,12 @@ export async function createMcpServer(context: {
     'instructions',
     'instructions://best-practices',
     {
-      title: 'Angular System Instructions',
+      title: 'Angular Best Practices and Code Generation Guide',
       description:
-        'A set of instructions to help LLMs generate correct code that follows Angular best practices.',
+        "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 () => {
@@ -46,18 +49,26 @@ export async function createMcpServer(context: {
   server.registerTool(
     'list_projects',
     {
-      title: 'List projects',
+      title: 'List Angular Projects',
       description:
-        'List projects within an Angular workspace.' +
-        ' This information is read from the `angular.json` file at the root path of the Angular workspace',
+        'Lists the names of all applications and libraries defined within an Angular workspace. ' +
+        'It reads the `angular.json` configuration file to identify the projects. ',
+      annotations: {
+        readOnlyHint: true,
+      },
     },
-    () => {
-      if (!context.workspace) {
+    async () => {
+      const { workspace } = context;
+
+      if (!workspace) {
         return {
           content: [
             {
-              type: 'text',
-              text: 'Not within an Angular project.',
+              type: 'text' as const,
+              text:
+                'No Angular workspace found.' +
+                ' An `angular.json` file, which marks the root of a workspace,' +
+                ' could not be located in the current directory or any of its parent directories.',
             },
           ],
         };
@@ -66,10 +77,8 @@ export async function createMcpServer(context: {
       return {
         content: [
           {
-            type: 'text',
-            text:
-              'Projects in the Angular workspace: ' +
-              [...context.workspace.projects.keys()].join(','),
+            type: 'text' as const,
+            text: 'Projects in the Angular workspace: ' + [...workspace.projects.keys()].join(','),
           },
         ],
       };