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