What is Laravel Mcp

Laravel-mcp is a collection of helper tools designed to enhance Laravel development specifically within the Cursor IDE. It aims to improve the development workflow and debugging capabilities directly in the editor.

Use cases

Use cases for laravel-mcp include debugging Laravel applications, managing log files efficiently, executing artisan commands without leaving the editor, and visualizing model relationships during development.

How to use

To use laravel-mcp, clone the repository, create a shell script wrapper to point to your Laravel project path, make the script executable, and ensure the script’s directory is in your PATH. Then, you can access the tools directly through Cursor’s command palette.

Key features

Key features include viewing recent log entries, searching log errors, executing artisan commands directly from Cursor, and displaying model information and relationships within the editor.

Where to use

Laravel-mcp is primarily used in web development projects that utilize the Laravel framework, particularly for developers who prefer using Cursor IDE for their development tasks.

Laravel Helpers MCP

⚠️ ALPHA SOFTWARE WARNING ⚠️
This package is currently in alpha stage. APIs and functionality may change without notice. Use in production at your own risk.

Overview

A collection of Laravel helper tools specifically designed for integration with Cursor IDE, improving development workflow and debugging capabilities directly within your editor.

Cursor Integration

This package is built to enhance your Laravel development experience in Cursor IDE. All tools are accessible directly through Cursor’s command palette and integrate seamlessly with your development workflow.

Available Tools

• tail_log_file: View the most recent entries in your Laravel log file directly in Cursor
• search_log_errors: Search through your log files for specific error patterns with integrated results
• run_artisan_command: Execute Laravel artisan commands directly from Cursor
• show_model: Display model information and relationships in your editor

Installation

1. Clone the repository:

git clone https://github.com/your-username/laravel-mcp.git
cd laravel-mcp

2. Create a shell script wrapper (e.g., ~/bin/run-laravel-mcp):

#!/bin/bash

# Point to your Laravel project path
export LARAVEL_PATH=/path/to/your/laravel/project

# Run the MCP server
mcp run /path/to/laravel-helpers-mcp/server.py

3. Make the script executable:

chmod +x ~/bin/run-laravel-mcp

4. Ensure ~/bin is in your PATH:

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
source ~/.zshrc  # or source ~/.bashrc

Requirements

• PHP 8.1+
• Laravel 10.0+
• Cursor IDE
• UV - Modern Python packaging tools

Contributing

This project is in active development. Issues and pull requests are welcome.

License

[License Type] - See LICENSE file for details