PHPackages                             ovac/laravel-mcp-inspector - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. ovac/laravel-mcp-inspector

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

ovac/laravel-mcp-inspector
==========================

A powerful MCP server inspector and documentation UI for Laravel — tools reference, interactive playground, scope explorer, and client connect guides.

001BladeCI passing

Since Mar 29Pushed 1mo agoCompare

[ Source](https://github.com/ovac/laravel-mcp-inspector)[ Packagist](https://packagist.org/packages/ovac/laravel-mcp-inspector)[ RSS](/packages/ovac-laravel-mcp-inspector/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel MCP Inspector
=====================

[](#laravel-mcp-inspector)

[![Latest Version on Packagist](https://camo.githubusercontent.com/917f9dada9ccc7f796196c54df09fd8c23c47804cb937d5c4acd4a6f0dff526f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f7661632f6c61726176656c2d6d63702d696e73706563746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ovac/laravel-mcp-inspector)[![License](https://camo.githubusercontent.com/26996ba77acc9c4d5b1dfeffb5b45e71ff2b5f14d4be9136ede3f111c05978ef/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6f7661632f6c61726176656c2d6d63702d696e73706563746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ovac/laravel-mcp-inspector)[![Tests](https://github.com/Gidipex/laravel-mcp-inspector/actions/workflows/tests.yml/badge.svg)](https://github.com/Gidipex/laravel-mcp-inspector/actions/workflows/tests.yml)

A powerful, beautiful inspection and documentation UI for Laravel MCP servers. Think of it as Scalar or Swagger UI, but purpose-built for the Model Context Protocol.

Features
--------

[](#features)

- **Interactive Tool Explorer** — Browse all MCP tools with descriptions, risk levels, schemas, and annotations
- **Live Playground** — Execute tools directly from the browser with a built-in JSON-RPC 2.0 client
- **Scope Explorer** — Visualize scopes and discover which tools each scope unlocks
- **Client Connect** — Ready-to-copy configuration for Claude Desktop, Cursor, and cURL
- **Dark &amp; Light Themes** — Beautiful UI with automatic system theme detection
- **Zero Config** — Auto-discovers your MCP tools from your Laravel config; no manifest scraping
- **Self-Contained** — Single Blade view with all CSS/JS inline; no build step required

Installation
------------

[](#installation)

```
composer require ovac/laravel-mcp-inspector
```

The package auto-registers its service provider via Laravel's package discovery.

Quick Start
-----------

[](#quick-start)

Once installed, visit:

```
https://your-app.test/mcp/inspector

```

The inspector reads your MCP tool definitions directly from your Laravel config (default key: `mcp_user_public`). No HTTP calls to the MCP manifest — this is what makes it fast and reliable.

Configuration
-------------

[](#configuration)

Publish the config file:

```
php artisan vendor:publish --tag=mcp-inspector-config
```

```
// config/mcp-inspector.php

return [
    'enabled' => env('MCP_INSPECTOR_ENABLED', true),
    'route_prefix' => 'mcp',
    'route_middleware' => ['web'],
    'config_key' => 'mcp_user_public',
    'title' => 'MCP Inspector',
    'theme' => 'auto', // auto|dark|light
];
```

### Options

[](#options)

KeyDefaultDescription`enabled``true`Enable/disable the inspector. Set to `false` in production if needed.`route_prefix``mcp`URL prefix. Inspector available at `/{prefix}/inspector`.`route_middleware``['web']`Middleware for the inspector route. Add `auth` to restrict access.`config_key``mcp_user_public`The Laravel config key containing your MCP server definition.`title``MCP Inspector`Title shown in the inspector UI header.`theme``auto`Default theme: `auto`, `dark`, or `light`.Customizing the View
--------------------

[](#customizing-the-view)

```
php artisan vendor:publish --tag=mcp-inspector-views
```

The published view will be in `resources/views/vendor/mcp-inspector/`.

MCP Config Format
-----------------

[](#mcp-config-format)

The inspector expects your MCP config to follow this structure:

```
// config/mcp_user_public.php

return [
    'name' => 'My MCP Server',
    'version' => '1.0.0',
    'description' => 'API tools for my application.',
    'tokens_url' => '/api/mcp/tokens',
    'mcp_endpoint' => '/mcp',

    'tools' => [
        [
            'name' => 'get_user',
            'description' => 'Retrieve a user by their ID.',
            'inputSchema' => [
                'type' => 'object',
                'properties' => [
                    'user_id' => [
                        'type' => 'integer',
                        'description' => 'The user ID.',
                    ],
                ],
                'required' => ['user_id'],
            ],
            'annotations' => [
                'scope' => 'users:read',
                'risk' => 'low',
                'readOnlyHint' => true,
            ],
        ],
    ],

    'scopes' => [
        [
            'name' => 'users:read',
            'description' => 'Read user data.',
            'tools' => ['get_user'],
        ],
    ],
];
```

Security
--------

[](#security)

For production, you should:

1. Disable the inspector: `MCP_INSPECTOR_ENABLED=false`
2. Or add authentication middleware:

```
// config/mcp-inspector.php
'route_middleware' => ['web', 'auth'],
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for recent changes.

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

---

Built with care by [Ariama Victor (Gidipex)](https://github.com/Gidipex).

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance60

Regular maintenance activity

Popularity1

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/805b47d522cbd469b4ce2cdc5f6cf1df088b54bd995d2cfce91fca02b9527765?d=identicon)[ovac](/maintainers/ovac)

---

Top Contributors

[![ovac](https://avatars.githubusercontent.com/u/5038672?v=4)](https://github.com/ovac "ovac (1 commits)")

### Embed Badge

![Health badge](/badges/ovac-laravel-mcp-inspector/health.svg)

```
[![Health](https://phpackages.com/badges/ovac-laravel-mcp-inspector/health.svg)](https://phpackages.com/packages/ovac-laravel-mcp-inspector)
```

###  Alternatives

[cubear/finder

Finder is a Drupal 8 module to help users find services which meet their criteria

404.2k](/packages/cubear-finder)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
