Laravel Codebase Introspection and Analysis

What is Laravel Codebase Introspection and Analysis?

A Model Context Protocol (MCP) server that allows AI agents to query structured information about a Laravel codebase – including views, routes, classes, and models – without reading all the source code. It is built on the mateffy/laravel-introspect package and supports wildcard queries and package introspection.

How to use Laravel Codebase Introspection and Analysis?

Install via Composer as a dev dependency: composer require mateffy/laravel-codebase-mcp --dev. Then add it to your AI agent’s MCP configuration using the artisan command introspect:mcp (see config example in README). The server is currently in beta.

Key features of Laravel Codebase Introspection and Analysis

• Query views, routes, classes, and models with structured filters
• Supports wildcard (*) matching for names, paths, etc.
• Can introspect code from Laravel packages
• Provides overviews of datamodel and model relationships
• Works with any AI agent implementing the MCP protocol

Use cases of Laravel Codebase Introspection and Analysis

• Give an AI an overview of the data model and its relationships
• Refactor views and verify they are not used elsewhere
• Find all routes that use a specific controller
• Locate models using a particular trait or interface
• Ensure all routes apply correct middleware

FAQ from Laravel Codebase Introspection and Analysis

What is the difference between laravel-codebase-mcp and laravel-introspect?

The MCP server uses the laravel-introspect package internally. If you need to run the same queries repeatedly or write tests, you can use the package directly.

What are the current runtime requirements or dependencies?

It requires PHP and Composer. There is a known dependency issue with php-mcp/server and ReactPHP that may require temporary patched forks (see README for repository overrides).

Where does the data live?

The server queries your local Laravel codebase; no external data storage is used.

What is the current status of the server?

The MCP server is in beta – bugs are expected.

What transport or authentication does it use?

The server runs via an artisan command (introspect:mcp) and is configured through your AI agent’s MCP configuration. No specific transport or authentication details are mentioned other than the command invocation.