Laravel Codebase Introspection and Analysis

Name: Laravel Codebase Introspection and Analysis
Author: capevace

@capevace

Repository

About Laravel Codebase Introspection and Analysis

MCP Server for Laravel Codebase Intelligence and Introspection

#laravel #php #analysis #introspection #refactoring #debugging

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.