gomdimapps/laravel-mcp-pilot

Token-lean toolkit for Laravel projects, built for MCP and other low-token AI integrations: a lexical index (classes, routes, views, frontend files, with pluggable schema extraction) and a driver-agnostic database introspection tool (list tables, describe schema, run guarded queries, optional Spatie

Maintainers

Package info

github.com/GomdimApps/LaravelMCPPilot

pkg:composer/gomdimapps/laravel-mcp-pilot

Transparency log

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.0 2026-07-22 00:25 UTC

Requires

Requires (Dev)

Suggests

  • spatie/laravel-permission: Enables Spatie Permission schema introspection (roles/permissions) in DatabaseIntrospectionService::describeTable().

MIT d10c46c8c27c6fdb7f520abffd5a3118c124b97f

  • GomdimApps <isac.gondim.dev.woop@gmail.com>

databasesearchlaravelindexaitypescriptmcpvue

Published on Packagist.org on 2026-07-22 00:32 UTC

This package is auto-updated.

Last update: 2026-07-22 00:34:18 UTC

README

Token-lean toolkit for Laravel projects — Lexical Search · Database Introspection

LaravelMCPPilot gives AI agents (or an MCP server) two cheap ways to explore a Laravel project: a lexical code index (classes, routes, views, frontend files, with schema extraction) and a driver-agnostic database introspection tool (list tables, describe schema, run guarded queries).

tests License

Quick Start

composer require gomdimapps/laravel-mcp-pilot
php artisan vendor:publish --tag=laravel-mcp-pilot-config

Search

use GomdimApps\LaravelMCPPilot\Search\SearchService;

$index = app(SearchService::class);
$index->refresh();
$index->search('store thing');

Database

use GomdimApps\LaravelMCPPilot\Database\DatabaseIntrospectionService;

$db = app(DatabaseIntrospectionService::class);
$db->listTables('pgsql', 'thing');
$db->describeTable('pgsql', 'things');

Requirements

Requirement Version
PHP >= 8.3
Laravel ^12.0 or ^13.0
spatie/laravel-permission (optional) ^6.0 — enables role/permission mapping in the Database tool

Features

  • 🔍 Lexical search — classes, routes, views, and frontend files by term, no AST/embeddings
  • 🗄️ Database introspection — tables, columns, indexes, and foreign keys on any Laravel-supported driver
  • 🧩 Pluggable indexers & schema extractors — extend the Search tool from your own app, no fork needed
  • 🔐 Safe by default — write queries (INSERT/UPDATE/DELETE) are disabled until explicitly enabled
  • 🎭 Optional Spatie Permission integration — auto-detected, zero hard dependency
  • 🧪 Fully tested — Pest + Testbench, Docker matrix, CI

Documentation

Full documentation is available at GomdimApps.github.io/LaravelMCPilot

Key sections:

Docker Testing

make test-8.3   # or test-8.4 / test-8.5
make test-all   # runs all three

License

MIT.