Phpcodearcheology: Análise Estática de PHP para Clareza Arquitetural com IA
Phpcodearcheology é uma ferramenta de análise estática projetada para aplicações PHP, exigindo PHP 8.2 ou superior para operação. Construído principalmente com PHP, funciona como um servidor nativo do Protocolo de Contexto de Modelo (MCP). Isso permite que assistentes de IA consultem diretamente os resultados da análise da base de código. Distribuído como um pacote Composer ou via Docker, Phpcodearcheology foca em insights de arquitetura e manutenibilidade, tornando bases de código PHP mais acessíveis e compreensíveis para fluxos de trabalho impulsionados por IA. Seu objetivo é apoiar engenheiros e arquitetos na gestão de projetos PHP complexos ou mal documentados.
O que o Phpcodearcheology conecta?
O Phpcodearcheology conecta-se a bases de código PHP para realizar análise estática, categorizando-o como uma ferramenta de análise estática de PHP. Seu foco principal é na arquitetura e na manutenibilidade dentro dessas bases de código. Ele opera como um servidor MCP nativo, permitindo que assistentes de IA consultem diretamente os resultados da análise. Essa integração direta permite interação dinâmica e recuperação de informações de projetos PHP, tornando os insights da base de código disponíveis através de vários clientes de IA compatíveis. Ele serve como uma ponte entre o código PHP e a compreensão da IA.
Recursos e ferramentas principais
Quando executado como um servidor MCP, o Phpcodearcheology expõe nove ferramentas chamáveis: pontuação de saúde, problemas, métricas, pontos quentes, prioridades de refatoração, dependências, listas de classes, grafo de conhecimento, e busca de código. Além disso, fornece ferramentas de linha de comando como "init", "compare", "baseline create", e "baseline check". O SDK do servidor PHP MCP subjacente suporta stdio, http+sse, e protocolos de transporte HTTP transmitíveis, garantindo comunicação flexível com vários clientes de IA e ambientes de desenvolvimento.
Para quem é?
O público principal do Phpcodearcheology inclui engenheiros e arquitetos responsáveis pela manutenção de aplicações PHP grandes ou mal documentadas. Também atende equipes que buscam integrar indexação de código ciente de IA em seus fluxos de trabalho de desenvolvimento PHP. A ferramenta suporta a compreensão de aspectos arquitetônicos, avaliação de dívida técnica e planejamento de esforços de refatoração. Pule isso se seu fluxo de trabalho não envolver indexação de código ciente de IA para projetos PHP.
Como começar
Nenhuma credencial é necessária. O servidor suporta stdio, http+sse, e protocolos de transporte HTTP transmitíveis.
Casos de uso
- Exploração e Compreensão da Base de Código: Assistentes de IA podem consultar a base de código usando linguagem natural para entender aspectos arquitetônicos como pontos quentes, gráficos de dependência e pontuações de saúde, ajudando a descobrir hierarquias de classes e rastrear usos de símbolos.
- Planejamento de Refatoração e Avaliação de Dívida Técnica: Quando integrado a um IDE assistido por IA, ajuda no planejamento de esforços de refatoração e na avaliação de dívida técnica, permitindo que os usuários consultem por "piores pontos quentes" e prioridades de refatoração.
- Integração CI/CD e Monitoramento de Qualidade: A ferramenta está pronta para CI/CD, suportando SARIF para Escaneamento de Código do GitHub, e permite o rastreamento de tendências de qualidade ao longo do tempo através do rastreamento de histórico e gerenciamento de baseline para projetos legados.
Phpcodearcheology oferece uma solução de análise estática especializada para PHP, atuando como um servidor MCP para integração de IA. Ele fornece insights valiosos sobre a arquitetura da base de código, manutenibilidade e dívida técnica. Sua compatibilidade com principais clientes de IA como Claude e Cursor aprimora os fluxos de trabalho de desenvolvimento para engenheiros PHP. A ferramenta também suporta processos de CI/CD, incluindo saída SARIF para rastreamento de qualidade.
