laravel-inertia-integration

Laravel and InertiaJS Integration Guide

Laravel Service Provider

Create a service provider to register MCP components in Laravel:

namespace MCP\Laravel;

use Illuminate\Support\ServiceProvider;
use MCP\Server\McpServer;
use MCP\Client\Client;
use MCP\Types\Implementation;

class McpServiceProvider extends ServiceProvider {
    public function register(): void {
        // Register MCP Server as singleton
        $this->app->singleton(McpServer::class, function ($app) {
            $server = new McpServer(
                new Implementation(
                    name: config('mcp.server.name', 'laravel-mcp'),
                    version: config('mcp.server.version', '1.0.0')
                )
            );

            // Auto-register tools from config
            foreach (config('mcp.tools', []) as $name => $config) {
                $handler = $app->make($config['handler']);
                $server->registerTool($name, $config['definition'], [$handler, 'handle']);
            }

            return $server;
        });

        // Register MCP Client
        $this->app->singleton(Client::class, function ($app) {
            return new Client(
                new Implementation(
                    name: config('mcp.client.name', 'laravel-client'),
                    version: config('mcp.client.version', '1.0.0')
                ),
                [
                    'capabilities' => config('mcp.client.capabilities', [])
                ]
            );
        });
    }

    public function boot(): void {
        // Publish config
        $this->publishes([
            __DIR__ . '/../config/mcp.php' => config_path('mcp.php'),
        ], 'mcp-config');

        // Register routes if enabled
        if (config('mcp.routes.enabled', false)) {
            $this->loadRoutesFrom(__DIR__ . '/../routes/mcp.php');
        }
    }
}

Configuration File

// config/mcp.php
return [
    'server' => [
        'name' => env('MCP_SERVER_NAME', 'laravel-mcp-server'),
        'version' => env('MCP_SERVER_VERSION', '1.0.0'),
        'transport' => env('MCP_SERVER_TRANSPORT', 'streamable-http'),
    ],

    'client' => [
        'name' => env('MCP_CLIENT_NAME', 'laravel-mcp-client'),
        'version' => env('MCP_CLIENT_VERSION', '1.0.0'),
        'capabilities' => [
            'sampling' => [],
            'roots' => ['listChanged' => true],
        ],
    ],

    'routes' => [
        'enabled' => env('MCP_ROUTES_ENABLED', true),
        'prefix' => env('MCP_ROUTES_PREFIX', 'mcp'),
        'middleware' => ['api'],
    ],

    'tools' => [
        'database-query' => [
            'definition' => [
                'title' => 'Database Query',
                'description' => 'Execute database queries',
                'inputSchema' => [
                    'type' => 'object',
                    'properties' => [
                        'query' => ['type' => 'string'],
                        'bindings' => ['type' => 'array'],
                    ],
                    'required' => ['query'],
                ],
            ],
            'handler' => \App\Mcp\Tools\DatabaseQueryTool::class,
        ],
    ],

    'auth' => [
        'enabled' => env('MCP_AUTH_ENABLED', false),
        'provider' => env('MCP_AUTH_PROVIDER', 'oauth'),
        'oauth' => [
            'client_id' => env('MCP_OAUTH_CLIENT_ID'),
            'client_secret' => env('MCP_OAUTH_CLIENT_SECRET'),
            'redirect_uri' => env('MCP_OAUTH_REDIRECT_URI'),
        ],
    ],
];