README

A reusable starter package for adding a Model Context Protocol (MCP) server to your Laravel projects, built on the official laravel/mcp package. It ships a small task-management domain as a working reference and gives you, ready to copy or extend, the patterns a production MCP server needs.

Features

• Tools (read + write), Resources (read-by-URI context), and Prompts (reusable templates)
• Per-tool authorization via Gate abilities — MCP is a third UI, never a back door
• uuid-only inputs/outputs — the internal auto-increment id never leaks to the agent
• Write tools funnel through Action classes — the agent, web UI, and CLI share one rule set
• STDIO (local) and Streamable HTTP (remote) transports
• Two HTTP auth methods — Sanctum personal access tokens and OAuth 2.1 (Passport) — on one endpoint
• Honest annotations (#[IsReadOnly]) so clients know which tools change state and gate them

Requirements

• PHP 8.4+
• Laravel 11, 12, or 13
• laravel/mcp ^0.8

Installation

composer require cleaniquecoders/laravel-mcp-kit
php artisan mcp-kit:install   # publishes config + migration (add --oauth to wire OAuth 2.1)
php artisan migrate

Then define the two Gate abilities every tool checks — see Installation.

Quick Start

php artisan mcp-kit:demo                          # seed demo tasks
claude mcp add mcp-kit -- php artisan mcp:start mcp-kit   # connect over STDIO

Set MCP_KIT_LOCAL_USER to the email the local transport should act as. See Quick Start for HTTP and OAuth.

Documentation

Full documentation lives in docs/:

Testing

composer test

Changelog

See CHANGELOG.md for recent changes.

License

MIT. © Nasrul Hazim / CleaniqueCoders. See LICENSE.md.