Laravel MCP

What is Laravel MCP?

A Laravel package for implementing the Model Context Protocol (MCP) in Laravel applications. It facilitates communication between AI models and Laravel applications through standardized interfaces.

How to use Laravel MCP?

Install via Composer (composer require laravelmcp/mcp), publish the config (php artisan vendor:publish --provider="..." --tag="config"), and set environment variables (e.g., MCP_SERVER_TRANSPORT). Start the server with php artisan mcp:serve [--transport] [--host] [--port]. Register tools, resources, and prompts using FastMCP or the MCP facade.

Key features of Laravel MCP

• Multiple transport options: HTTP, WebSocket, and Stdio
• Tool registration, execution, and error handling
• Resource management with URI-based access and templates
• Prompt system with templates, arguments, and context management
• Real-time progress tracking and client notification
• Structured logging with multiple log levels
• Model preferences configuration (cost, intelligence, speed priorities)

Use cases of Laravel MCP

• Building AI assistants that interact with Laravel applications
• Real-time code review assistants that analyze complexity and suggest improvements
• Exposing database records or file contents as resources via MCP
• Integrating CLI tools with AI models using Stdio transport
• Creating chat applications with prompt history and context management

FAQ from Laravel MCP

What are the system requirements?

PHP 8.1+, Laravel 10.x, Composer 2.x, and several PHP extensions (OpenSSL, PDO, Mbstring, XML, Ctype, JSON). Optional: Redis, Supervisor, ext-pcntl, ext-posix.

How do I install Laravel MCP?

Run composer require laravelmcp/mcp. The package automatically registers its service provider and facade.

What transport options are available?

HTTP (RESTful), WebSocket (real-time), and Stdio (command-line). You can also use a transport factory.

How do I register a custom tool?

Use FastMCP or the MCP facade. Define parameters and a callback (e.g., $mcp->tool('calculate', [...]) (function($args) { ... })). Returns structured responses with error handling.

Where is the full documentation?

Comprehensive PHPDoc is in the source code (src/ directory). Online documentation is available at mohamedahmed01.github.io/laravel-mcp-sdk.