Laravel Helper Tools

🚀 Laravel 工具 MCP

一組專為與 Cursor IDE 集成設計的 Laravel 輔助工具，能直接在編輯器中提升開發工作流和調試能力，讓開發更高效。

🚀 快速開始

此包目前處於 alpha 階段，API 和功能可能會發生變化，恕不另行通知。在生產環境中使用此包請自行承擔風險。

✨ 主要特性

• 此包專為增強你在 Cursor IDE 中的 Laravel 開發體驗而構建。所有工具均可直接通過 Cursor 的命令 palette 訪問，並與你的開發流程無縫集成。
• 提供了一系列實用工具，如查看日誌、搜索錯誤、執行 Artisan 命令、顯示模型信息等。

📦 安裝指南

1. 克隆倉庫：

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

2. 創建 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

3. 賦予腳本執行權限：

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

4. 確保 ~/bin 在你的 PATH 中：

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

💻 使用示例

基礎用法

此包提供了多個實用工具，以下是各工具的使用說明：

• tail_log_file：在 Cursor 中查看 Laravel 日誌文件中的最新條目。
• search_log_errors：搜索特定錯誤模式，結果直接在編輯器中顯示。
• run_artisan_command：直接從 Cursor 執行 Laravel Artisan 命令。
• show_model：顯示模型信息和關係，在你的編輯器中展示。

📚 詳細文檔

兼容性要求

• PHP 8.1+
• Laravel 10.0+
• Cursor IDE
• UV - 現代 Python 包裝工具

貢獻指南

此項目正在積極開發中。歡迎提出問題和拉取請求。

📄 許可證

[許可類型] - 詳細信息請參見 LICENSE 文件