Laravel Artisan MCP Server

🚀 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

1. Clone the repository:

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

2. Set up a virtual environment (recommended):

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

3. 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

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

Claude Integration

To use with Claude:

1. Import the MCP protocol definition.
2. Configure the Claude proxy to point to your Laravel project directory.
3. 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.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

This MCP server was created with the assistance of Claude (Claude is an AI assistant by Anthropic).