Angular CLI MCP Server 🅰️

A Model Context Protocol server that provides Angular CLI and workspace automation capabilities. This server enables LLMs and agents to interact with Angular projects, generate components/services, add packages, create new workspaces, and run custom architect targets via the Angular CLI.

Features

- Run ng generate to scaffold Angular artifacts (components, services, etc.)
- Run ng add to add packages to your Angular workspace
- Run ng new to create new Angular workspaces
- Run ng run to execute custom architect targets
- Run ng update to update Angular packages and dependencies

- All via the Model Context Protocol (MCP) for agent/LLM integration

Installation

You can install the package globally using npm:

``bash npm install -g @talzach/mcp-angular-cli`

Or use it locally in your project:

`bash npm install --save-dev @talzach/mcp-angular-cli`

`Usage`

You can run the server directly:

`bash npx @talzach/mcp-angular-cli`

Or, if you want to use it as a custom MCP server in your agent or tool, configure it like this:

`$3`

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

`Example Tool Usage`

- Generate a component:`json { "schematic": "component", "name": "my-component", "appRoot": "/absolute/path/to/your/angular/project" }`- Add a package:`json { "package": "@angular/material", "appRoot": "/absolute/path/to/your/angular/project" }`- Create a new workspace:`json { "name": "my-workspace", "directory": "/absolute/path/to/where/you/want/it" }`- Run a custom architect target:`json { "target": "app:build:production", "appRoot": "/absolute/path/to/your/angular/project" }`

---

Star this repo if you find it useful!

`Publishing to npm`

To publish a new version of this package to npm, run:

`bash npm run publish-npm`

This will automatically build the project and publish it as a public package.

`Develop`

If you want to test or develop this server locally, you need to point your MCP server configuration to your local build output. After building the project (e.g., with npm run build), set your MCP server file (e.g., .mcp.json or similar) to use the local dist/index.js file:

`json { "angular-cli": { "command": "node", "args": ["/path/to/your/mcp-angular-cli/dist/index.js"] } }``

Features

- All via the Model Context Protocol (MCP) for agent/LLM integration

Example Tool Usage

- Generate a component:

json
  {
    "schematic": "component",
    "name": "my-component",
    "appRoot": "/absolute/path/to/your/angular/project"
  }


- Add a package:

json
  {
    "package": "@angular/material",
    "appRoot": "/absolute/path/to/your/angular/project"
  }


- Create a new workspace:

json
  {
    "name": "my-workspace",
    "directory": "/absolute/path/to/where/you/want/it"
  }


- Run a custom architect target:

json
  {
    "target": "app:build:production",
    "appRoot": "/absolute/path/to/your/angular/project"
  }

---

Star this repo if you find it useful!

Develop

If you want to test or develop this server locally, you need to point your MCP server configuration to your local build output. After building the project (e.g., with

npm run build), set your MCP server file (e.g., .mcp.json or similar) to use the local dist/index.js file:

json
{
  "angular-cli": {
    "command": "node",
    "args": ["/path/to/your/mcp-angular-cli/dist/index.js"]
  }
}