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