Angular MCP Server

Model Context Protocol tools built for Angular — not generic file search.

v1.0.0 — Open source under MIT. Works with Cursor, Claude Desktop, and any MCP-compatible client.

Why Angular needs its own MCP Server

Generic MCP servers treat your codebase like a bag of files. Angular applications are not.

Angular projects have structure: components, directives, pipes, routes, lazy-loaded modules, standalone APIs, signals, dependency injection, and template syntax that generic tools cannot reliably parse or reason about.

An Angular-native MCP server gives AI assistants real project intelligence:

| Capability | Generic MCP | Angular MCP Server | |---|---|---| | Find components by selector | ❌ Text search | ✅ Decorator analysis | | Map route → component | ❌ Guess from filenames | ✅ Router config parsing | | Audit enterprise architecture | ❌ | ✅ 7 rules + health score | | Generate CRUD with Kendo UI | ❌ | ✅ Angular 20 + Kendo patterns |

MCP Tools (v1.0.0)

| Tool | Description | |---|---| | get_project_info | Read angular.json and summarize workspace projects | | find_component | Search components by selector, class name, or path | | list_routes | Parse *.routes.ts files into a route tree | | audit_architecture | Enterprise audit: 7 rules, health score, grade (A-F) | | generate_crud | Generate Angular 20 + Kendo UI CRUD scaffold |

Quick Start

Option A — npm (recommended)

npx @mhdd_24/angular-mcp-server

Or install globally:

npm install -g @mhdd_24/angular-mcp-server
angular-mcp-server

Option B — clone from GitHub

git clone https://github.com/Mhdd-24/angular-mcp-server.git
cd angular-mcp-server
npm install
npm run build

Cursor / Claude Desktop MCP config

Using npx (no install):

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

Using a local clone:

{
  "mcpServers": {
    "angular-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/angular-mcp-server/dist/index.js"]
    }
  }
}

See examples/cursor-mcp-config.json for a template.

Examples

| Workspace | Demo | |---|---| | basic-standalone | find_component, list_routes | | enterprise-layered | audit_architecture |

Building in Public (series complete)

| # | Topic | Link | |---|---|---| | 1 | Why Angular needs its own MCP Server | Read → | | 2 | Architecture | Read → | | 3 | Live demo: components and routes | Demo → | | 4 | CRUD generation with Kendo UI | Demo → | | 5 | Enterprise architecture audit | Demo → | | 6 | Open-source release and roadmap | Read → |

Roadmap

See ROADMAP.md for planned features:

• v1.1 — TypeScript AST parser, find_service
• v1.2 — analyze_dependencies (DI graph)
• v1.3 — OpenAPI → services, Kendo dialogs
• v1.4 — Custom rules, monorepo support

Contributing

Contributions welcome — especially from enterprise Angular teams. See CONTRIBUTING.md.

npm run dev      # watch mode
npm test         # run tests
npm run build    # compile

License

MIT © 2026