angular

This Angular MCP Server exposes a set of tools to help AI assistants fetch and reason about Angular documentation. It provides search capabilities (search_angular_docs) to locate topics across 15 categories, a topic reader (get_angular_topic) for detailed explanations, a category listing (list_angular_categories) with topic counts, a comprehensive overview (get_angular_overview) of Angular features, and a code example finder (find_angular_examples) for practical snippets. The server is designed to be integrated with MCP-enabled assistants such as Claude Desktop, VSCode Cline, and Amazon Q, allowing natural language queries to be converted into structured MCP requests and returning relevant results, code samples, and references from Angular documentation. To use it, configure your MCP client with the angular-docs server entry and start the server via your preferred interface. The tools are described with clear parameters and usage patterns so the client can construct precise requests like querying for lifecycle methods, DI patterns, routing concepts, or example snippets. The server aggregates Angular topics and code examples, delivering relevant results with ranking to help the AI provide concise, useful answers.

Prerequisites:

• Node.js v18.0.0 or higher
• npm v8.0.0 or higher

Installation steps:

1. Clone the repository

   git clone https://github.com/SAIPRANAY-GANGULA/angular-mcp-server.git
   cd angular-mcp-server
   

2. Install dependencies

   npm install
   

3. Build the server (optional for development)

   npm run build
   

4. Run the server (development or after build)

   npm run start
   

Notes:

• The server exposes multiple MCP tools for Angular documentation. Ensure your MCP client is configured to point at the angular-docs entry (e.g., via npx angular-mcp-server as shown in the README).
• If you prefer a production deployment, consider building the project and running the output from the build/ directory with node.

Tips and considerations:

• Ensure Node.js v18+ is installed to match the project requirements.
• If you encounter MCP client connection issues, verify the JSON configuration for the mcpServers entry in your client settings.
• The server's documentation coverage includes 84 topics across 15 categories; if categories or topics appear missing, ensure the llms.txt and llms-full.txt resources are properly loaded during build.
• When using the npx approach in environments with restricted network access, pre-install the angular-mcp-server package locally or set up a local npm proxy.
• Environment variables are typically not required, but you may want to expose PORT or API_BASE in production deployments if hosting behind a reverse proxy.