Laravel Helpers MCP

基本能力

产品定位

Laravel Helpers MCP 是一个专为 Laravel 开发者设计的工具集合，旨在与 Cursor IDE 集成，提升开发工作流和调试能力。

核心功能

• tail_log_file: 直接在 Cursor 中查看 Laravel 日志文件的最新条目
• search_log_errors: 在日志文件中搜索特定的错误模式，并集成结果显示
• run_artisan_command: 直接从 Cursor 执行 Laravel artisan 命令
• show_model: 在编辑器中显示模型信息及其关系

适用场景

• Laravel 开发者在 Cursor IDE 中进行开发时，需要快速查看日志、搜索错误、执行 artisan 命令或查看模型信息。

工具列表

• tail_log_file: 查看 Laravel 日志文件的最新条目
• search_log_errors: 搜索日志文件中的错误模式
• run_artisan_command: 执行 Laravel artisan 命令
• show_model: 显示模型信息及其关系

常见问题解答

• 该工具包目前处于 alpha 阶段，API 和功能可能会发生变化，不建议在生产环境中使用。

使用教程

使用依赖

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

安装教程

1. 克隆仓库：

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

1. 创建一个 shell 脚本包装器（例如 ~/bin/run-laravel-mcp）：

#!/bin/bash

# 指向你的 Laravel 项目路径
export LARAVEL_PATH=/path/to/your/laravel/project

# 运行 MCP 服务器
mcp run /path/to/laravel-helpers-mcp/server.py

1. 使脚本可执行：

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

1. 确保 ~/bin 在你的 PATH 中：

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

调试方式

安装完成后，可以通过运行 run-laravel-mcp 脚本来启动 MCP 服务器，并在 Cursor IDE 中使用提供的工具进行调试。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。