Laravel Artisan MCP Server
@diggy
A Model Context Protocol (MCP) server that enables secure execution of Laravel Artisan commands through Claude and other MCP clients.
Overview
What is Laravel Artisan MCP Server?
Laravel Artisan MCP Server is a Model Context Protocol (MCP) server that enables secure execution of Laravel Artisan commands through Claude and other MCP clients. It acts as a bridge between AI assistants and local Laravel applications, allowing controlled management of Laravel projects via natural language conversations.
How to use Laravel Artisan MCP Server?
Clone the repository, create a Python virtual environment, install dependencies with uv add "mcp[cli]", then set the ARTISAN_DIRECTORY and WHITELISTED_COMMANDS environment variables. Configure the server in your MCP-compatible client (e.g., Claude Desktop) by adding a JSON entry pointing to artisan_mcp_server.py. Two tools are available: run_artisan to execute a whitelisted command and list_all_artisan_commands to display all available commands.
Key features of Laravel Artisan MCP Server
- Executes only whitelisted Artisan commands
- Automatically locates PHP on your system
- Accesses a single configured Laravel project directory
- Lists all available Artisan commands in the project
- Provides robust input validation and error handling
Use cases of Laravel Artisan MCP Server
- Clear the application cache by asking Claude to run
cache:clear - List all registered routes in a Laravel project via
route:list - View all available Artisan commands without leaving your AI assistant
- Generate controllers, models, or other classes using
make:*commands when whitelisted
FAQ from Laravel Artisan MCP Server
How is the server secured?
The server implements directory isolation (only accesses the configured Laravel folder), command whitelisting (only allows explicitly permitted commands), input validation, and error handling to prevent sensitive information leakage.
What are the runtime requirements?
Python 3.10 or higher, a Laravel project with the Artisan CLI, PHP installed and accessible in your system PATH, and an MCP-compatible client such as Claude Desktop.
Where does my project data live?
All commands execute on your local machine within the specified Laravel directory. The server never sends your project code or data to external services.
What commands can I run?
Only the commands listed in the WHITELISTED_COMMANDS environment variable (e.g., route:list,cache:clear,make:controller). You can see the full whitelist by asking the assistant.
How do I debug connection issues?
Verify that ARTISAN_DIRECTORY points to a valid Laravel project containing the Artisan executable, that PHP is in your PATH, and that all environment variables are correctly set in your MCP client configuration.
