@depup/angular__cli 21.2.1-depup.1

package/src/commands/mcp/mcp-server.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPERIMENTAL_TOOL_GROUPS = exports.EXPERIMENTAL_TOOLS = void 0;
+exports.createMcpServer = createMcpServer;
+exports.assembleToolDeclarations = assembleToolDeclarations;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const node_path_1 = require("node:path");
+const version_1 = require("../../utilities/version");
+const host_1 = require("./host");
+const instructions_1 = require("./resources/instructions");
+const ai_tutor_1 = require("./tools/ai-tutor");
+const best_practices_1 = require("./tools/best-practices");
+const build_1 = require("./tools/build");
+const devserver_start_1 = require("./tools/devserver/devserver-start");
+const devserver_stop_1 = require("./tools/devserver/devserver-stop");
+const devserver_wait_for_build_1 = require("./tools/devserver/devserver-wait-for-build");
+const doc_search_1 = require("./tools/doc-search");
+const e2e_1 = require("./tools/e2e");
+const index_1 = require("./tools/examples/index");
+const modernize_1 = require("./tools/modernize");
+const zoneless_migration_1 = require("./tools/onpush-zoneless-migration/zoneless-migration");
+const projects_1 = require("./tools/projects");
+const test_1 = require("./tools/test");
+const tool_registry_1 = require("./tools/tool-registry");
+/**
+ * Tools to manage devservers. Should be bundled together, then added to experimental or stable as a group.
+ */
+const DEVSERVER_TOOLS = [devserver_start_1.DEVSERVER_START_TOOL, devserver_stop_1.DEVSERVER_STOP_TOOL, devserver_wait_for_build_1.DEVSERVER_WAIT_FOR_BUILD_TOOL];
+/**
+ * The set of tools that are enabled by default for the MCP server.
+ * These tools are considered stable and suitable for general use.
+ */
+const STABLE_TOOLS = [
+    ai_tutor_1.AI_TUTOR_TOOL,
+    best_practices_1.BEST_PRACTICES_TOOL,
+    doc_search_1.DOC_SEARCH_TOOL,
+    index_1.FIND_EXAMPLE_TOOL,
+    projects_1.LIST_PROJECTS_TOOL,
+    zoneless_migration_1.ZONELESS_MIGRATION_TOOL,
+];
+/**
+ * The set of tools that are available but not enabled by default.
+ * These tools are considered experimental and may have limitations.
+ */
+exports.EXPERIMENTAL_TOOLS = [
+    build_1.BUILD_TOOL,
+    e2e_1.E2E_TOOL,
+    modernize_1.MODERNIZE_TOOL,
+    test_1.TEST_TOOL,
+    ...DEVSERVER_TOOLS,
+];
+/**
+ * Experimental tools that are grouped together under a single name.
+ *
+ * Used for enabling them as a group.
+ */
+exports.EXPERIMENTAL_TOOL_GROUPS = {
+    'all': exports.EXPERIMENTAL_TOOLS,
+    'devserver': DEVSERVER_TOOLS,
+};
+async function createMcpServer(options, logger) {
+    const server = new mcp_js_1.McpServer({
+        name: 'angular-cli-server',
+        version: version_1.VERSION.full,
+    }, {
+        capabilities: {
+            resources: {},
+            tools: {},
+            logging: {},
+        },
+        instructions: `
+<General Purpose>
+This server provides a safe, programmatic interface to the Angular CLI for an AI assistant.
+Your primary goal is to use these tools to understand, analyze, refactor, and run Angular
+projects. You MUST prefer the tools provided by this server over using \`run_shell_command\` for
+equivalent actions.
+</General Purpose>
+
+<Core Workflows & Tool Guide>
+* **1. Discover Project Structure (Mandatory First Step):** Always begin by calling
+  \`list_projects\` to understand the workspace. The \`path\` property for a workspace
+  is a required input for other tools.
+
+* **2. Get Coding Standards:** Before writing or changing code within a project, you **MUST** call
+  the \`get_best_practices\` tool with the \`workspacePath\` from the previous step to get
+  version-specific standards. For general knowledge, you can call the tool without this path.
+
+* **3. Answer User Questions:**
+    - For conceptual questions ("what is..."), use \`search_documentation\`.
+    - For code examples ("show me how to..."), use \`find_examples\`.
+</Core Workflows & Tool Guide>
+
+<Key Concepts>
+* **Workspace vs. Project:** A 'workspace' contains an \`angular.json\` file and defines 'projects'
+  (applications or libraries). A monorepo can have multiple workspaces.
+* **Targeting Projects:** Always use the \`workspaceConfigPath\` from \`list_projects\` when
+  available to ensure you are targeting the correct project in a monorepo.
+</Key Concepts>
+`,
+    });
+    (0, instructions_1.registerInstructionsResource)(server);
+    const toolDeclarations = assembleToolDeclarations(STABLE_TOOLS, exports.EXPERIMENTAL_TOOLS, {
+        ...options,
+        logger,
+    });
+    await (0, tool_registry_1.registerTools)(server, {
+        workspace: options.workspace,
+        logger,
+        exampleDatabasePath: (0, node_path_1.join)(__dirname, '../../../lib/code-examples.db'),
+        devservers: new Map(),
+        host: host_1.LocalWorkspaceHost,
+    }, toolDeclarations);
+    return server;
+}
+function assembleToolDeclarations(stableDeclarations, experimentalDeclarations, options) {
+    let toolDeclarations = [...stableDeclarations];
+    if (options.readOnly) {
+        toolDeclarations = toolDeclarations.filter((tool) => tool.isReadOnly);
+    }
+    if (options.localOnly) {
+        toolDeclarations = toolDeclarations.filter((tool) => tool.isLocalOnly);
+    }
+    const enabledExperimentalTools = new Set(options.experimentalTools);
+    if (process.env['NG_MCP_CODE_EXAMPLES'] === '1') {
+        enabledExperimentalTools.add('find_examples');
+    }
+    for (const [toolGroupName, toolGroup] of Object.entries(exports.EXPERIMENTAL_TOOL_GROUPS)) {
+        if (enabledExperimentalTools.delete(toolGroupName)) {
+            for (const tool of toolGroup) {
+                enabledExperimentalTools.add(tool.name);
+            }
+        }
+    }
+    if (enabledExperimentalTools.size > 0) {
+        const experimentalToolsMap = new Map(experimentalDeclarations.map((tool) => [tool.name, tool]));
+        for (const toolName of enabledExperimentalTools) {
+            const tool = experimentalToolsMap.get(toolName);
+            if (tool) {
+                toolDeclarations.push(tool);
+            }
+            else {
+                options.logger.warn(`Unknown experimental tool: ${toolName}`);
+            }
+        }
+    }
+    return toolDeclarations;
+}
+//# sourceMappingURL=mcp-server.js.map

package/src/commands/mcp/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["mcp-server.ts"],"names":[],"mappings":"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"}