sourcecodeguy1/laravel-mcp-server

MCP server for Laravel — expose routes, schema, models, and migrations to AI agents like Claude

v1.3.1 2026-05-29 22:17 UTC

Requires

• php: ^8.1
• illuminate/console: ^10.0|^11.0|^12.0|^13.0
• illuminate/database: ^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Julio Sandoval

• laravel
• Devtools
• ai
• mcp
• claude
• model-context-protocol

README

An MCP (Model Context Protocol) server for Laravel applications. Install it in any Laravel app, run one Artisan command, and AI agents like Claude get live read-only access to your application's internals — routes, database schema, Eloquent models, migrations, and environment keys.

Requirements

• PHP 8.1+
• Laravel 10, 11, 12, or 13

Installation

composer require sourcecodeguy1/laravel-mcp-server

The service provider is auto-discovered. Optionally publish the config:

php artisan vendor:publish --tag=laravel-mcp-config

Usage

Start the MCP server:

php artisan mcp:serve

The server runs over stdio and speaks the Model Context Protocol. Connect any MCP-compatible client to it.

Claude Desktop Setup

Add this to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "laravel": {
      "command": "php",
      "args": ["/absolute/path/to/your/laravel/app/artisan", "mcp:serve"]
    }
  }
}

Then restart Claude Desktop. You'll see a hammer icon in the chat — that means the tools are connected.

Available Tools

Tool	Description
list_routes	All registered routes with method, URI, controller, middleware. Filterable by HTTP method or URI pattern.
get_schema	List all database tables, or pass a table name to get columns and indexes.
list_models	All Eloquent models with table name, fillable/hidden fields, and detected relationships.
get_migrations	Migration status — which have been run (with batch number) and which are pending.
get_env_keys	All .env key names. Never returns values — keys only, for security.
list_middleware	All registered middleware — global stack, named aliases, and groups (web, api, etc.).

Example Questions You Can Ask Claude

• "What routes in this app are missing auth middleware?"
• "Show me the columns in the users table"
• "Which models have a BelongsToMany relationship?"
• "Are there any pending migrations?"
• "What third-party services does this app integrate with?" (from env keys)

Configuration

After publishing the config, you can enable/disable individual tools:

// config/laravel-mcp.php
return [
    'tools' => [
        \Sourcecodeguy1\LaravelMcp\Tools\ListRoutesTool::class,
        \Sourcecodeguy1\LaravelMcp\Tools\GetSchemaTool::class,
        \Sourcecodeguy1\LaravelMcp\Tools\ListModelsTool::class,
        \Sourcecodeguy1\LaravelMcp\Tools\GetMigrationsTool::class,
        \Sourcecodeguy1\LaravelMcp\Tools\GetEnvKeysTool::class,
        \Sourcecodeguy1\LaravelMcp\Tools\ListMiddlewareTool::class,
    ],
];

Security

• Read-only — no tool writes to the database or filesystem
• Env values never exposed — get_env_keys returns key names only
• Intended for local development use with Claude Desktop, not production exposure

License

MIT — Julio Sandoval