Laravel Codebase Introspection

Servidor MCP para Inteligência e Introspecção de Codebase Laravel

Para que IAs consigam entender seu codebase, elas precisam saber o que há nele. Embora a busca vetorial seja uma ferramenta poderosa para pesquisar código, ela usa muitos tokens e nem sequer dá a visão completa do seu codebase para coisas como views ou rotas. Este pacote implementa um servidor Model Context Protocol (MCP) para o pacote mateffy/laravel-introspect, que permite introspectar seu codebase e obter informações estruturadas sobre ele.

• 🔍 Permite que a IA consulte views, rotas, classes e modelos sem precisar ler todo o código
• 🔍 Pode até usar curingas (*) para corresponder a múltiplas views, rotas, classes e modelos
• 🔍 Suporta consultas a coisas de pacotes Laravel, o que a maioria dos buscadores de arquivos não consegue
• 🪄 Dá à sua IA visões rápidas do seu modelo de dados e seus relacionamentos
• 🤖 Suporta qualquer agente de IA que implemente o protocolo MCP

Consulta	Filtros Disponíveis
Views	nome, caminho, usado por view, usa view, estende
Rotas	nome, URI, controller + fn, métodos, middleware
Classes	nome / namespace, estende pai, implementa interfaces, usa traits
⤷ Modelos	... relacionamentos, propriedades, casts, fillable, hidden, leitura/escrita
⤷ Comandos	... assinatura, descrição (em breve)

Nome e algumas outras consultas também suportam consultas com curingas (ex.: components.*.paragraph)

Para quem é isso?

Se você usa ferramentas de IA como Aider, Cursor, Windsurf ou Claude Code para ajudar a construir seu aplicativo, este pacote é para você. Basta configurar o servidor MCP no seu agente e ele poderá consultar automaticamente seu codebase em busca de views, rotas, classes e modelos.

Isso é especialmente útil para codebases grandes, onde apenas pesquisar no código é menos prático.

Exemplos de tarefas

• Dar à sua IA uma visão geral do seu modelo de dados e seus relacionamentos
• Refatorar views e garantir que não sejam usadas em nenhum outro lugar
• Encontrar todas as rotas que usam um controller específico
• Encontrar modelos que usam um trait ou interface específica
• Garantir que todas as rotas estejam usando o middleware correto

laravel-codebase-mcp vs. laravel-introspect

O servidor MCP usa o pacote laravel-introspect para introspectar seu codebase e obter informações estruturadas sobre ele. Se você quiser escrever testes ou executar as mesmas consultas várias vezes, também pode simplesmente usar o pacote diretamente.

Instalação

Instale o pacote via composer:

composer require mateffy/laravel-codebase-mcp --dev

[!NOTE]

No momento, há um problema de dependência com php-mcp/server (#23) e ReactPHP (#542). Você pode precisar temporariamente usar estes forks corrigidos se encontrar problemas ao instalar laravel-codebase-mcp, adicionando o seguinte ao seu composer.json:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/leantime/php-mcp-server.git"
    },
    {
      "type": "vcs",
      "url": "https://github.com/Leantime/reactphp-http.git"
    }
  ]
}

E então adicione-o à configuração MCP do seu agente de IA:

{
  "mcpServers": {
    "laravel-introspect": {
      "command": "php",
      "args": [
        "/path/to/your/codebase/artisan",
        "introspect:mcp"
      ]
    }
  }
}

[!IMPORTANT]
O servidor MCP ainda está em beta, provavelmente haverá bugs!

Consultas disponíveis

Se você quiser ver todas as consultas disponíveis, consulte a documentação do pacote laravel-introspect.

Agradecimentos

O servidor MCP usa o pacote php-mcp/server para implementar o protocolo MCP.

Licença

A Licença MIT (MIT). Consulte o Arquivo de Licença para mais informações.