Angular MCP Server

Un servidor MCP para acceder a la documentación oficial de Angular.

Documentación

Angular MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona acceso integral a la documentación de Angular, permitiendo a los asistentes de IA buscar y recuperar información relacionada con Angular con una puntuación de relevancia inteligente.

Características

El servidor proporciona 5 herramientas potentes para la documentación de Angular:

🔍 `search_angular_docs`

Busca en la documentación de Angular temas, conceptos o palabras clave específicos con puntuación de relevancia inteligente.

Parámetros:
- query (obligatorio): Consulta de búsqueda (p. ej., "componentes", "inyección de dependencias", "enrutamiento")
- category (opcional): Filtrar por categoría (Componentes, Plantillas, Directivas, etc.)
- limit (opcional): Número máximo de resultados (predeterminado: 5)

📖 `get_angular_topic`

Obtén información detallada sobre un tema específico de Angular.

Parámetros:
- topic (obligatorio): Nombre del tema específico (p. ej., "Ciclo de vida de componentes", "Resumen de señales")

📋 `list_angular_categories`

Lista todas las categorías disponibles de documentación de Angular con recuentos de temas.

🌟 `get_angular_overview`

Obtén una visión general completa del framework Angular y sus características.

💡 `find_angular_examples`

Encuentra ejemplos de código e implementaciones prácticas para conceptos de Angular.

Parámetros:
- concept (obligatorio): Concepto de Angular para encontrar ejemplos (p. ej., "componente", "servicio", "directiva")

Uso

Con Claude Desktop

Añade esta configuración a los ajustes de MCP de tu Claude Desktop:

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"]
    }
  }
}

Con VSCode (Cline)

Añade a los ajustes de MCP de tu Cline: ~/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": []
    }
  }
}

Con Amazon Q para línea de comandos

La CLI de Amazon Q admite servidores MCP mediante configuración. Añade esto a tu configuración de MCP:

{
  "mcpServers": {
    "angular-docs": {
      "command": "npx",
      "args": ["angular-mcp-server"]
    }
  }
}

Una vez configurado, puedes interactuar con la documentación de Angular directamente a través de 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 utilizará automáticamente el Angular MCP Server para proporcionar documentación completa de Angular y ejemplos de código.

Consultas de ejemplo

Una vez integrado con tu asistente de IA, puedes hacer preguntas como:

"Buscar métodos del ciclo de vida de componentes de Angular"
"Muéstrame información sobre las señales de Angular"
"Encuentra ejemplos de inyección de dependencias en Angular"
"Lista todas las categorías de documentación de Angular"
"Obtén una visión general del framework Angular"
"¿Cómo implemento formularios reactivos en Angular?"
"¿Cuáles son las mejores prácticas para pruebas en Angular?"

Cobertura de documentación

El servidor proporciona acceso a 84 temas de documentación de Angular en 15 categorías:

Componentes (7 temas) - Fundamentos de componentes, ciclo de vida, estilos, entradas/salidas
Plantillas (7 temas) - Sintaxis de plantillas, enlace, flujo de control, variables
Directivas (5 temas) - Directivas integradas y personalizadas, composición
Señales (3 temas) - Programación reactiva con señales de Angular
Inyección de dependencias (7 temas) - Patrones de DI, proveedores, servicios
Formularios (6 temas) - Formularios reactivos y basados en plantillas, validación
Enrutamiento (7 temas) - Navegación, guardias de ruta, carga diferida
Cliente HTTP (5 temas) - Comunicación con API, interceptores, pruebas
Pruebas (12 temas) - Pruebas unitarias, pruebas de componentes, pruebas e2e
Renderizado del lado del servidor (6 temas) - SSR, hidratación, prerenderizado
Animaciones (3 temas) - Animaciones de componentes y rutas
Integración con RxJS (2 temas) - Observables con Angular
APIs y CLI (2 temas) - Documentación de referencia
Temas avanzados (9 temas) - Rendimiento, seguridad, mejores prácticas
Primeros pasos (3 temas) - Instalación, configuración, guía de estilo

Desarrollo

Compilación desde el código fuente

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

Scripts

npm run build: Compilar TypeScript y copiar archivos de documentación
npm run start: Ejecutar el servidor compilado
npm run dev: Compilar y ejecutar en modo de desarrollo
npm run test: Probar con el inspector de MCP

Estructura del proyecto

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

Requisitos

Node.js: v18.0.0 o superior
npm: v8.0.0 o superior

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una solicitud de extracción. Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.

Haz un fork del repositorio
Crea tu rama de características (git checkout -b feature/AmazingFeature)
Realiza tus cambios (git commit -m 'Add some AmazingFeature')
Envía los cambios a la rama (git push origin feature/AmazingFeature)
Abre una solicitud de extracción

Solución de problemas

Problemas comunes

El servidor no se inicia: Asegúrate de que Node.js v18+ esté instalado
Errores de permisos: Intenta ejecutar con sudo para instalación global
El cliente MCP no se conecta: Verifica la sintaxis del archivo de configuración
Sin resultados de búsqueda: Comprueba que los archivos de documentación estén cargados correctamente

Obtener ayuda

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Agradecimientos

Construido con el Model Context Protocol SDK
Documentación de Angular obtenida de angular.dev
Inspirado por el creciente ecosistema de MCP

Hecho con ❤️ para la comunidad de Angular y IA

Angular MCP Server

Documentación