packages/angular/cli/src/commands/mcp/cli.ts - main - githubmirror/angular-cli

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

92 строки2 KB

Charles Lyding

refactor(@angular/cli): use `serveStdio` to support both 2025 and 2026-07-28 MCP protocol eras

05 авг 2026, 09:16

05 авг 2026, 09:16b6ed402

/**
 * @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
 */

import { serveStdio } from '@modelcontextprotocol/server/stdio';
import type { Argv } from 'yargs';
import {
  CommandModule,
  type CommandModuleImplementation,
} from '../../command-builder/command-module';
import { isTTY } from '../../utilities/tty';
import { createMcpServer } from './mcp-server';

const INTERACTIVE_MESSAGE = `
To start using the Angular CLI MCP Server, add this configuration to your host:

{
  "mcpServers": {
    "angular-cli": {
      "command": "npx",
      "args": ["-y", "@angular/cli", "mcp"]
    }
  }
}

Exact configuration may differ depending on the host.

For more information and documentation, visit: https://angular.dev/ai/mcp
`;

export default class McpCommandModule extends CommandModule implements CommandModuleImplementation {
  command = 'mcp';
  describe = false as const;
  longDescriptionPath = undefined;

  builder(localYargs: Argv): Argv {
    return localYargs
      .option('root', {
        type: 'string',
        array: true,
        describe:
          'Allowed root directory paths for filesystem access and workspace discovery. Can be specified multiple times.',
      })
      .option('read-only', {
        type: 'boolean',
        default: false,
        describe: 'Only register read-only tools.',
      })
      .option('local-only', {
        type: 'boolean',
        default: false,
        describe: 'Only register tools that do not require internet access.',
      })
      .option('experimental-tool', {
        type: 'string',
        alias: 'E',
        array: true,
        describe: 'Enable an experimental tool.',
        hidden: true,
      });
  }

  async run(options: {
    root: string[] | undefined;
    readOnly: boolean;
    localOnly: boolean;
    experimentalTool: string[] | undefined;
  }): Promise<void> {
    if (isTTY()) {
      this.context.logger.info(INTERACTIVE_MESSAGE);

      return;
    }

    serveStdio(() =>
      createMcpServer(
        {
          workspace: this.context.workspace,
          readOnly: options.readOnly,
          localOnly: options.localOnly,
          experimentalTools: options.experimentalTool,
          roots: options.root,
        },
        this.context.logger,
      ),
    );
  }
}