Laravel Artisan MCP Server

A Laravel Artisan command execution server based on the MCP protocol that allows securely managing local Laravel projects through an AI assistant.

Developer tools Artificial intelligence chatbots #Laravel tools #Command execution #AI integration #Development assistance .Python

rating : 2 points

downloads : 14

update time : 2025-04-23

What is the Laravel Artisan MCP Server?

This is a bridge server that allows AI assistants (such as Claude) to securely manage your local Laravel projects through natural language conversations. It converts your language instructions into controlled Artisan commands for execution.

How to use the Laravel Artisan MCP Server?

You need to install a Python environment, configure the Laravel project path, set the list of allowed commands, and then interact with the server through an MCP-compatible client (such as Claude).

Applicable scenarios

It is particularly useful when you want to quickly execute common Laravel development tasks (such as viewing the route list, clearing the cache, creating controllers, etc.) through natural language without having to memorize specific commands.

Main features

Secure command executionOnly execute Artisan commands in the pre-configured whitelist to prevent accidental or dangerous operations

Automatic environment detectionAutomatically find the PHP and Laravel Artisan executables on the system

Command list viewingYou can view all available Artisan commands to easily understand the available functions

Multi-client supportCompatible with various MCP clients, including Claude Desktop

Advantages and limitations

Advantages

Control Laravel projects through natural language to improve development efficiency

Strict security control, only allowing execution of whitelisted commands

No need to memorize complex Artisan command syntax

Seamless integration with existing development tools

Limitations

Only support local Laravel projects

Need to pre-configure the list of allowed commands

Dependent on Python and PHP environments

Not suitable for production environments

How to use

Installation preparation

Ensure that Python 3.10+, PHP, and a Laravel project are installed on the system

Clone the repository

Get the server code

Create a virtual environment

Set up a Python virtual environment

Install dependencies

Install the necessary Python dependencies

Configure environment variables

Set the Laravel project path and the list of allowed commands

Start the server

Run the MCP server

Usage examples

View the route listGet information about all defined routes in the application

Clear the application cacheClean the application cache to solve cache problems in development

Create a new controllerQuickly generate a new controller file

Frequently Asked Questions

Why can't my command be executed?

How to add more allowed commands?

Is this server secure?

How to integrate with Claude?

Why can't PHP be found?

Related resources

GitHub repository

Project source code and latest updates

Laravel documentation

Official documentation for the Laravel framework

MCP protocol

Official description of the Model Context Protocol

🚀 Laravel Artisan MCP Server

A Model Context Protocol (MCP) server that securely executes Laravel Artisan commands via Claude and other MCP clients. This server acts as a bridge between an AI assistant and your local Laravel application, enabling controlled management through natural language conversations.

🚀 Quick Start

The Laravel Artisan MCP Server serves as a crucial link between AI assistants and local Laravel applications, facilitating controlled management through natural - language dialogues.

✨ Features

Access a single directory containing a Laravel project.
Automatically locate PHP in the system.
Only execute Artisan commands on the whitelist.
View all available Artisan commands.
Securely designed with robust input validation.

💻 Usage Examples

Examples are omitted (there were graphical parts in the original text).

📦 Installation

Prerequisites

PHP must be installed and in the system's PATH.
The Laravel project directory must exist and be accessible.
Composer must be installed.

Steps

Clone the repository:

git clone https://github.com/your - repository.git
cd laravel - artisan - mcp - server

Set up a virtual environment (recommended):

python3 -m venv venv
source venv/bin/activate  # Use `venv\Scripts\activate` on Windows

Install dependencies:
```
composer install
```

📚 Documentation

Configuration

Set the following environment variables in the configuration file:

ARTISAN_DIRECTORY: Specify the directory path of the Laravel project.
PHP_EXECUTABLE (optional): Specify the path to the PHP executable.

For example, in the .env file:

ARTISAN_DIRECTORY=/path/to/laravel - project
PHP.Executable=/usr/bin/php8

Testing

Test with MCP Inspector

Install and start MCP Inspector.
Configure the target server in the Inspector.
Send commands to verify the connection and command execution.

Claude Integration

To use with Claude:

Import the MCP protocol definition.
Configure the Claude proxy to point to your Laravel project directory.
Interact using Artisan commands.

For example, here is a simple call:

claire run --protocol mcp - v1 \
    --config - path config.json \
    --directory /path/to/laravel - project \
    --command "php artisan migrate"

Tools

claire: Used to communicate with the Claude proxy.
mcp - inspector: Used to test and debug the MCP server.

Security Considerations

Directory Isolation: Only access the specified Laravel directory.
Command Whitelist: Only execute allowed commands.
Input Validation: All inputs are validated.
Error Handling: Prevent sensitive information leakage.

Troubleshooting

"ARTISAN_DIRECTORY must be provided in the configuration"

Check:

Whether the environment variables are set correctly.
Whether the directory exists and is accessible.

"Artisan not found in /path/to/artisan"

Check:

Whether the specified directory contains a Laravel project.
Whether the Artisan file exists and has execution permissions.

"PHP executable not found"

Check:

Whether PHP is installed on the system.
Whether the PHP executable is in the PATH.

Disclaimer

This Laravel Artisan MCP server is provided as - is without any warranties. Back up your project data before use. It is intended for development or testing environments only.