laravel-mcp-ops maintained by eloquage
Description
Aggregate MCP ops server — auth status and pluggable health checks
Author
Last update
2026/11/03 16:07
(dev-main)
License
Downloads
3
Tags
Laravel MCP Ops

An aggregate Laravel MCP server for infrastructure health and authentication status across installed integrations.
Requires PHP 8.4+, Laravel 11, 12, or 13, and laravel/mcp ^0.9.
Install
composer require eloquage/laravel-mcp-ops
php artisan vendor:publish --tag=mcp-ops-config
The package registers a local MCP server named ops and a web endpoint at /mcp/ops. Start the local server with:
php artisan mcp:start ops
Tools
| Tool | What it reports |
|---|---|
health_check |
Infrastructure checks from the registered HealthCheckRunner. |
auth_status |
Authentication health from installed AuthStatusProvider integrations. |
When spatie/laravel-health is installed, the package registers its health runner by default. You can bind your own implementation:
use Eloquage\LaravelMcpOps\Contracts\HealthCheckRunner;
$this->app->bind(HealthCheckRunner::class, YourHealthCheckRunner::class);
Optional integrations register their auth providers automatically when installed, including Google Workspace, NotebookLM, and Vector Search. You can add a custom provider by implementing AuthStatusProvider and tagging it:
$this->app->singleton(MyAuthStatusProvider::class);
$this->app->tag([MyAuthStatusProvider::class], 'mcp-ops.auth-providers');
Configuration
| Setting | Environment variable | Default |
|---|---|---|
| Local MCP handle | MCP_OPS_LOCAL_HANDLE |
ops |
| Web MCP path | MCP_OPS_WEB_PATH |
/mcp/ops |
| Auto-register Spatie health | MCP_OPS_HEALTH_AUTO_REGISTER_SPATIE |
true |
| Google auth remediation | MCP_OPS_GOOGLE_REMEDIATION |
php artisan google:auth |
| NotebookLM remediation | MCP_OPS_NOTEBOOKLM_REMEDIATION |
nlm login |
Tests
composer install
composer test
composer analyse
composer format -- --test
License
MIT. See LICENSE.md.