Angular MCP Server

Um servidor MCP para acessar a documentação oficial do Angular.

Documentação

Angular MCP Server

Um servidor Model Context Protocol (MCP) que fornece acesso abrangente à documentação do Angular, permitindo que assistentes de IA pesquisem e recuperem informações relacionadas ao Angular com pontuação inteligente de relevância.

Recursos

O servidor fornece 5 ferramentas poderosas para documentação do Angular:

🔍 `search_angular_docs`

Pesquise na documentação do Angular por tópicos, conceitos ou palavras-chave específicos com pontuação inteligente de relevância.

Parâmetros:
- query (obrigatório): Consulta de pesquisa (ex.: "components", "dependency injection", "routing")
- category (opcional): Filtrar por categoria (Components, Templates, Directives, etc.)
- limit (opcional): Número máximo de resultados (padrão: 5)

📖 `get_angular_topic`

Obtenha informações detalhadas sobre um tópico específico do Angular.

Parâmetros:
- topic (obrigatório): Nome do tópico específico (ex.: "Component lifecycle", "Signals overview")

📋 `list_angular_categories`

Liste todas as categorias disponíveis da documentação do Angular com contagens de tópicos.

🌟 `get_angular_overview`

Obtenha uma visão geral abrangente do framework Angular e seus recursos.

💡 `find_angular_examples`

Encontre exemplos de código e implementações práticas para conceitos do Angular.

Parâmetros:
- concept (obrigatório): Conceito do Angular para encontrar exemplos (ex.: "component", "service", "directive")

Uso

Com Claude Desktop

Adicione esta configuração às configurações MCP do seu 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"]
    }
  }
}

Com VSCode (Cline)

Adicione às configurações MCP do seu 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": []
    }
  }
}

Com Amazon Q para linha de comando

O CLI do Amazon Q suporta servidores MCP por meio de configuração. Adicione isto à sua configuração MCP:

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

Uma vez configurado, você pode interagir com a documentação do Angular diretamente através do 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"

O Amazon Q usará automaticamente o Angular MCP Server para fornecer documentação abrangente do Angular e exemplos de código.

Exemplos de Consultas

Uma vez integrado ao seu assistente de IA, você pode fazer perguntas como:

"Pesquisar métodos do ciclo de vida de componentes do Angular"
"Mostre-me informações sobre signals do Angular"
"Encontre exemplos de injeção de dependência no Angular"
"Liste todas as categorias da documentação do Angular"
"Obtenha uma visão geral do framework Angular"
"Como implemento formulários reativos no Angular?"
"Quais são as melhores práticas para testes no Angular?"

Cobertura da Documentação

O servidor fornece acesso a 84 tópicos de documentação do Angular em 15 categorias:

Components (7 tópicos) - Fundamentos de componentes, ciclo de vida, estilos, entradas/saídas
Templates (7 tópicos) - Sintaxe de templates, binding, fluxo de controle, variáveis
Directives (5 tópicos) - Diretivas integradas e personalizadas, composição
Signals (3 tópicos) - Programação reativa com signals do Angular
Dependency Injection (7 tópicos) - Padrões de DI, providers, serviços
Forms (6 tópicos) - Formulários reativos e orientados a template, validação
Routing (7 tópicos) - Navegação, guardas de rota, carregamento preguiçoso
HTTP Client (5 tópicos) - Comunicação com API, interceptors, testes
Testing (12 tópicos) - Testes unitários, testes de componentes, testes e2e
Server-Side Rendering (6 tópicos) - SSR, hidratação, pré-renderização
Animations (3 tópicos) - Animações de componentes e rotas
RxJS Integration (2 tópicos) - Observables com Angular
APIs & CLI (2 tópicos) - Documentação de referência
Advanced Topics (9 tópicos) - Performance, segurança, melhores práticas
Getting Started (3 tópicos) - Instalação, configuração, guia de estilo

Desenvolvimento

Compilando a partir do código-fonte

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 e copiar arquivos de documentação
npm run start: Executar o servidor compilado
npm run dev: Compilar e executar em modo de desenvolvimento
npm run test: Testar com o MCP inspector

Estrutura do Projeto

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 ou superior
npm: v8.0.0 ou superior

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas, abra uma issue primeiro para discutir o que você gostaria de alterar.

Faça um fork do repositório
Crie sua branch de recurso (git checkout -b feature/AmazingFeature)
Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
Envie para a branch (git push origin feature/AmazingFeature)
Abra um Pull Request

Solução de Problemas

Problemas Comuns

Servidor não inicia: Certifique-se de que o Node.js v18+ está instalado
Erros de permissão: Tente executar com sudo para instalação global
Cliente MCP não conecta: Verifique a sintaxe do arquivo de configuração
Sem resultados de pesquisa: Verifique se os arquivos de documentação estão carregados corretamente

Obtendo Ajuda

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Agradecimentos

Construído com o Model Context Protocol SDK
Documentação do Angular proveniente de angular.dev
Inspirado pelo ecossistema MCP em crescimento

Feito com ❤️ para a comunidade Angular e IA

Angular MCP Server

Documentação