ghostfolio/.agents/skills/angular-developer/references/mcp.md

Angular CLI MCP Server

The Angular CLI includes a Model Context Protocol (MCP) server that enables AI assistants (like Cursor, Gemini CLI, JetBrains AI, etc.) to interact directly with the Angular CLI. It provides tools for project analysis, guided migrations, and running builds/tests.

Available Tools (Default)

When the MCP server is enabled, AI agents have access to the following tools:

Name	Description
ai_tutor	Launches an interactive AI-powered Angular tutor.
get_best_practices	Retrieves the Angular Best Practices Guide (crucial for standalone components, typed forms, etc.).
list_projects	Lists all applications and libraries in the workspace by reading angular.json.
onpush_zoneless_migration	Analyzes code and provides a plan to migrate it to OnPush change detection (prerequisite for zoneless).
search_documentation	Searches the official documentation at https://angular.dev.

Experimental Tools

Some tools must be enabled explicitly using the --experimental-tool (or -E) flag.

Name	Description
build	Performs a one-off build using ng build.
devserver.start	Asynchronously starts a dev server (ng serve). Returns immediately.
devserver.stop	Stops the dev server.
devserver.wait_for_build	Returns the logs of the most recent build in a running dev server.
e2e	Executes end-to-end tests.
test	Runs the project's unit tests.

Configuration

To use the MCP server, you configure your host environment (IDE or CLI) to run npx @angular/cli mcp.

Antigravity IDE

Create a file named .antigravity/mcp.json in your project's root:

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

Gemini CLI

Create .gemini/settings.json in the project root:

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

Cursor

Create .cursor/mcp.json in the project root (or globally at ~/.cursor/mcp.json):

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

VS Code

Create .vscode/mcp.json:

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

Command Options

You can pass arguments to the MCP server in the args array of your configuration:

• --read-only: Only registers tools that do not modify the project.
• --local-only: Only registers tools that do not require an internet connection.
• --experimental-tool (-E): Enables specific experimental tools (e.g., -E build, -E devserver).

Example for read-only mode with experimental tools enabled:

"args": ["-y", "@angular/cli", "mcp", "--read-only", "-E", "build", "-E", "test"]