Laravel Artisan MCP Server

🚀 Laravel 藝術家artisan MCP 服務器

Laravel 藝術家artisan MCP 服務器是一個模型上下文協議（MCP）服務器，它藉助Claude和其他MCP客戶端，能夠安全地執行Laravel藝術家命令。該服務器就像一座橋樑，連接著AI助手和您本地的Laravel應用程序，支持通過自然語言對話對應用進行受控管理。

✨ 主要特性

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

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/your-repository.git
   cd laravel-artisan-mcp-server
   

2. 設置虛擬環境（推薦）：

   python3 -m venv venv
   source venv/bin/activate  # 在Windows上使用`venv\Scripts\activate`
   

3. 安裝依賴項：

   composer install
   

📚 詳細文檔

🔧 配置

需在配置文件中設置以下環境變量：

• ARTISAN_DIRECTORY：指定Laravel項目的目錄路徑。
• PHP_EXECUTABLE（可選）：指定PHP的可執行文件路徑。

例如，在.env文件中：

ARTISAN_DIRECTORY=/path/to/laravel-project
PHP.Executable=/usr/bin/php8

🧪 測試

使用MCP Inspector測試

1. 安裝並啟動MCP Inspector。
2. 在Inspector中配置目標服務器。
3. 發送命令以驗證連接和命令執行。

🤝 Claude集成

若要在Claude中使用，可按以下步驟操作：

1. 導入MCP協議定義。
2. 配置Claude代理指向您的Laravel項目目錄。
3. 使用藝術家命令進行交互。

例如，以下是一個簡單的調用：

claire run --protocol mcp-v1 \
    --config-path config.json \
    --directory /path/to/laravel-project \
    --command "php artisan migrate"

🛠️ 工具

• claire：用於與Claude代理通信。
• mcp-inspector：用於測試和調試MCP服務器。

⚠️ 安全考慮

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

❓ 故障排除

"ARTISAN_DIRECTORY 必須在配置中提供"

需檢查：

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

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

需檢查：

• 指定的目錄是否包含Laravel項目。
• 藝術家文件是否存在並具有執行權限。

"找不到PHP可執行文件"

需檢查：

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

⚠️ 免責聲明

此Laravel藝術家MCP服務器按原樣提供，不作任何保證。使用前請備份項目數據，且僅限在開發或測試環境中使用。

📄 許可證

本項目根據MIT許可證授權，詳情見LICENSE 文件。

👨‍💻 作者

此MCP服務器由Claude協助創建（Claude 是Anthropic的AI助手）。