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.

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(','),
           },
         ],
       };