Angular MCP Server
A Model Context Protocol (MCP) server that provides comprehensive access to Angular documentation, enabling AI assistants to search and retrieve Angular-related information with intelligent relevance scoring.
Features
The server provides 5 powerful tools for Angular documentation:
🔍 search_angular_docs
Search Angular documentation for specific topics, concepts, or keywords with intelligent relevance scoring.
- Parameters:
query(required): Search query (e.g., "components", "dependency injection", "routing")category(optional): Filter by category (Components, Templates, Directives, etc.)limit(optional): Maximum number of results (default: 5)
📖 get_angular_topic
Get detailed information about a specific Angular topic.
- Parameters:
topic(required): Specific topic name (e.g., "Component lifecycle", "Signals overview")
📋 list_angular_categories
List all available Angular documentation categories with topic counts.
🌟 get_angular_overview
Get a comprehensive overview of the Angular framework and its features.
💡 find_angular_examples
Find code examples and practical implementations for Angular concepts.
- Parameters:
concept(required): Angular concept to find examples for (e.g., "component", "service", "directive")
Usage
With Claude Desktop
Add this configuration to your Claude Desktop MCP settings:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"angular-docs": {
"command": "npx",
"args": ["angular-mcp-server"]
}
}
}
With VSCode (Cline)
Add to your Cline MCP settings:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
{
"mcpServers": {
"angular-docs": {
"command": "npx",
"args": ["angular-mcp-server"],
"disabled": false,
"autoApprove": []
}
}
}
With Amazon Q for command line
Amazon Q CLI supports MCP servers through configuration. Add this to your MCP configuration:
{
"mcpServers": {
"angular-docs": {
"command": "npx",
"args": ["angular-mcp-server"]
}
}
}
Once configured, you can interact with Angular documentation directly through Amazon Q:
# Start Amazon Q chat with MCP support
q chat
# Example queries you can ask:
# "Search for Angular component lifecycle methods"
# "Show me dependency injection examples"
# "How do I implement reactive forms?"
# "List all Angular documentation categories"
Amazon Q will automatically use the Angular MCP Server to provide comprehensive Angular documentation and code examples.
Example Queries
Once integrated with your AI assistant, you can ask questions like:
- "Search for Angular component lifecycle methods"
- "Show me information about Angular signals"
- "Find examples of dependency injection in Angular"
- "List all Angular documentation categories"
- "Get an overview of Angular framework"
- "How do I implement reactive forms in Angular?"
- "What are the best practices for Angular testing?"
Documentation Coverage
The server provides access to 84 Angular documentation topics across 15 categories:
- Components (7 topics) - Component basics, lifecycle, styling, inputs/outputs
- Templates (7 topics) - Template syntax, binding, control flow, variables
- Directives (5 topics) - Built-in and custom directives, composition
- Signals (3 topics) - Reactive programming with Angular signals
- Dependency Injection (7 topics) - DI patterns, providers, services
- Forms (6 topics) - Reactive and template-driven forms, validation
- Routing (7 topics) - Navigation, route guards, lazy loading
- HTTP Client (5 topics) - API communication, interceptors, testing
- Testing (12 topics) - Unit testing, component testing, e2e testing
- Server-Side Rendering (6 topics) - SSR, hydration, prerendering
- Animations (3 topics) - Component and route animations
- RxJS Integration (2 topics) - Observables with Angular
- APIs & CLI (2 topics) - Reference documentation
- Advanced Topics (9 topics) - Performance, security, best practices
- Getting Started (3 topics) - Installation, setup, style guide
Development
Building from Source
git clone https://github.com/SAIPRANAY-GANGULA/angular-mcp-server.git
cd angular-mcp-server
npm install
npm run build
Scripts
npm run build: Compile TypeScript and copy documentation filesnpm run start: Run the compiled servernpm run dev: Build and run in development modenpm run test: Test with MCP inspector
Project Structure
angular-mcp-server/
├── src/
│ ├── index.ts # Main server implementation
│ ├── llms.txt # Angular docs structure
│ └── llms-full.txt # Detailed Angular content
├── build/ # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── LICENSE
└── README.md
Requirements
- Node.js: v18.0.0 or higher
- npm: v8.0.0 or higher
Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Troubleshooting
Common Issues
- Server not starting: Ensure Node.js v18+ is installed
- Permission errors: Try running with
sudofor global installation - MCP client not connecting: Verify the configuration file syntax
- No search results: Check that the documentation files are properly loaded
Getting Help
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Built with the Model Context Protocol SDK
- Angular documentation sourced from angular.dev
- Inspired by the growing MCP ecosystem
Made with ❤️ for the Angular and AI community