Install Laravel MCP Hub 1.0¶
The ardanayatraa/laravel-mcp-hub package provides source connectors and a server SDK for Laravel applications. It assumes no particular user model, business table, permission package, or billing system.
Prerequisites¶
Use PHP and Laravel versions from the compatibility matrix, Composer, and the extensions required by dependency resolution. The package accepts Guzzle 7.15.2+ and Guzzle 8, so a fresh Laravel 13 application installs it without -W (package 1.0.1 or later). You need a stable APP_KEY, a metadata database, a Hub reachable from the application, and a source URL reachable from the Hub.
Review the plan, then run:
Production requires --migrate --force after the application's normal backup and review process. This command runs only package migration files, not application business migrations or application schema dumps.
Installation artifacts¶
| Artifact | Contents |
|---|---|
config/mcp-hub.php |
Initial configuration, only if the file does not exist |
mcp_hub_nonces |
Replay prevention through SQL uniqueness |
mcp_hub_commands |
Proposals and transaction receipts |
mcp_hub_exports |
Private report metadata |
Laravel discovers the provider automatically. If the host disables package discovery, register McpHub\Laravel\McpHubServiceProvider using the provider mechanism for your Laravel version.
Default state¶
The default resolver denies identity, the model registry is empty, and writes and exports are disabled. Installation does not grant data access. Implement a resolver and policies before enabling resources.
Doctor may report incomplete configuration before pairing. Continue with pairing and configuration.
The local prototype is a different dependency
mcp-hub/laravel-connector is the old pilot dependency. It shares the public package's PHP namespace, so both must not be installed together. Review dependencies, routes, and host integrations before replacing it.