Laravel Artisan MCP

🚀 Laravel 藝術家 MCP 服務器

Laravel 藝術家 MCP 服務器是一個基於模型上下文協議 (MCP) 的服務器，它允許通過 Claude 和其他 MCP 客戶端，以安全的方式執行 Laravel 藝術家命令。該服務器就像一座橋樑，連接了 AI 助手和本地的 Laravel 應用程序，讓你可以通過自然語言對話，對 Laravel 項目進行受控管理。

✨ 主要特性

• 單目錄訪問：可訪問包含一個 Laravel 項目的單個目錄。
• 自動定位 PHP：能自動定位系統中的 PHP。
• 白名單命令執行：僅執行列入白名單的藝術家命令。
• 查看可用命令：支持查看所有可用的藝術家命令。
• 安全設計：具備強大的輸入驗證機制，保障系統安全。

🖼️ 示例

📦 安裝指南

克隆倉庫

git clone https://github.com/diggy/laravel-artisan-mcp.git
cd laravel-artisan-mcp

創建虛擬環境並安裝依賴項

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt

運行服務器

python server.py

⚙️ 配置說明

編輯配置文件 config.py，設置以下參數：

• ARTISAN_DIRECTORY：指定您的 Laravel 項目目錄。
• COMMAND_WHITELIST：列出允許的命令。

💻 使用示例

執行藝術家命令

python server.py --command "php artisan migrate"

顯示幫助信息

python server.py --help

⚠️ 安全注意事項

• 目錄隔離：僅訪問指定配置的 Laravel 目錄。
• 命令白名單：僅執行特定允許的命令。
• 輸入驗證：在執行前驗證所有輸入。
• 錯誤處理：防止敏感信息洩露。

🛠️ 故障排除

"ARTISAN_DIRECTORY 必須在配置中提供"

服務器無法找到您的 Laravel 項目路徑。請檢查以下內容：

• 環境變量是否正確設置。
• 目錄是否存在且可訪問。

"未在 /path/to/artisan 中找到藝術家"

指定的目錄不包含藝術家可執行文件。請驗證以下內容：

• 路徑指向有效的 Laravel 項目目錄。
• 藝術家文件存在且具有可執行權限。

"PHP 可執行文件未找到"

服務器無法在 PATH 中找到 PHP。請確保以下內容：

• 已安裝 PHP。
• PHP 可執行文件位於系統 PATH 中。

❗ 免責聲明

此 Laravel 藝術家 MCP 服務器按原樣提供，不附帶任何形式的擔保或保證。使用本軟件即表示您同意承擔與其操作相關的所有風險。該服務器可以在開發或測試環境中執行命令，影響您的應用程序數據和功能。我們強烈建議僅在瞭解其安全含義並實施適當防護措施的情況下在生產 Laravel 應用程序中使用此工具。始終在允許 AI 助手通過此接口執行藝術家命令之前備份您的 Laravel 項目。本軟件未接受正式的安全審核，應被視為實驗性。自行承擔風險。

📄 許可證

該項目根據 MIT 許可證發佈 - 請參閱 LICENSE 文件以獲取詳細信息。

👨‍💻 作者

此 MCP 服務器由 Claude（Anthropic 的 AI 助手）協助開發（他堅持添加此謙遜的感謝，同時承諾不會包含表情符號或過多的熱情）。