Laravel Boost：從 Code Generator 進化成真正理解專案的 AI Agent

Laravel Boost 與 Laravel MCP 技術分享
讓 AI 真正進入你的 Laravel 專案，而不是只會猜

以前使用 AI 寫 Laravel，我最常遇到的問題不是 AI 不會寫 PHP，而是：

AI 根本不知道我的專案。

它不知道 Laravel 版本、不知道目前用了哪些套件、不知道資料庫 Schema、不知道既有的架構規則，也不知道某個問題其實已經有現成的 Service、Policy 或 Helper。

於是很容易出現這種情況：

AI：建議新增一個 Service。
實際上：專案裡已經有同功能的 Service。

或者：

AI：這是 Filament 3 的寫法。
實際上：專案使用的是 Filament 4。

甚至：

AI：新增一個 Permission。
實際上：專案早就有完整的 Gate + Policy + Shield + 自訂權限 Resolver。

這也是我開始關注 Laravel Boost 的原因。

Laravel Boost 是 Laravel 官方團隊提供的 AI 開發工具，核心目的就是讓 AI Coding Agent 取得 Laravel 專案真正需要的 Context、Tools、Guidelines 與 Skills。官方目前將它定位為：

Laravel-focused MCP server for augmenting your AI powered local development experience.

---

一、Laravel Boost 到底是什麼？

如果要用一句話解釋：

Laravel Boost 就是 Laravel 與 AI Coding Agent 之間的一座橋。

傳統 AI Coding 大概是：

text

開發者
   ↓
AI
   ↓
看你提供的程式碼
   ↓
猜測專案架構
   ↓
產生程式碼

加入 Laravel Boost 之後：

text

AI Coding Agent
                       │
                 Laravel Boost
                       │
        ┌──────────────┼──────────────┐
        ↓              ↓              ↓
     MCP Tools      Guidelines      Skills
        │              │              │
        └──────────────┼──────────────┘
                       ↓
                Laravel Application
                       │
          ┌────────────┼────────────┐
          ↓            ↓            ↓
        Code         MySQL        Logs

AI 不再只能依賴模型記憶，它可以透過 Boost：

• 了解 Laravel / PHP 版本
• 了解安裝了哪些 Laravel 生態套件
• 查看 Eloquent Models
• 查看 Database Schema
• 執行 Database Query
• 查看 Laravel Log
• 查看 Browser Logs
• 取得最後一次錯誤
• 搜尋 Laravel / 套件官方文件

目前官方列出的 Boost MCP 工具包含 Application Info、Database Schema、Database Query、Browser Logs、Last Error、Read Log Entries、Search Docs 等。

這個差異非常大。

---

二、Laravel Boost 和 Laravel MCP 不一樣

這也是我覺得最容易搞混的地方。

Laravel 現在有兩個相關套件：

• laravel/mcp
• laravel/boost

但用途完全不同。

Laravel MCP
主要是讓你建立自己的 MCP Server。

text

你的 Laravel Application
        ↓
自訂 MCP Server
        ↓
AI / 外部系統

你可以自己設計 Tool、Resource、Prompt，把業務能力暴露給任何 MCP Client。

Laravel Boost
則是讓 AI Coding Agent 更了解你的 Laravel 專案。

text

TRAE / Cursor / Claude Code
            ↓
       Laravel Boost
            ↓
     你的 Laravel 專案

所以如果你的目的只是：

「我要讓 TRAE / Cursor 更懂我的 Laravel 專案，幫我寫得更準。」

那麼你真正需要研究的是 Laravel Boost。

而 Laravel Boost 本身就是建立在 Laravel MCP 之上的——它提供的那些開發工具，全部都是 MCP Tools。

---

三、安裝 Laravel Boost

安裝非常簡單：

Bash

composer require laravel/boost --dev
php artisan boost:install

Boost 會偵測你的開發環境與 AI Agent，並產生對應的 MCP、Guidelines、Skills 等資源。

安裝之後，你會開始看到類似：

• .mcp.json
• .ai/
• 不同 Agent 所需要的設定檔

這些東西的目的不是取代你的 Laravel 程式碼，而是：

把你的 Laravel 專案變成 AI 更容易理解的開發環境。

核心啟動指令：

Bash

php artisan boost:mcp

如果 IDE 需要手動註冊 MCP，官方提供的設定方式是：

JSON

{
    "mcpServers": {
        "laravel-boost": {
            "command": "php",
            "args": ["artisan", "boost:mcp"]
        }
    }
}

---

四、Boost 最重要的 MCP Tools

1. Application Info

AI 先了解你的環境。

假設專案是 PHP 8.2 + Laravel 11 + Filament 4 + Livewire + Spatie Media Library。
Boost 可以直接提供這些資訊，AI 不用再靠猜。

2. Database Schema

這個對企業 Laravel 專案非常重要。

很多 Bug 根本不是 PHP 語法問題，而是 Model ≠ Database。
AI 可以直接確認 table、column、type、relationship，再開始改 Code。

3. Database Query

AI 可以直接驗證資料。

以前要手動開 Tinker 查詢再貼給 AI，現在 Agent 可以自己查，工作流程變成真正的 Debugging。

4. Logs（Last Error、Read Log Entries、Browser Logs）

這是我認為 Boost 最實用的功能之一。

從「請貼錯誤訊息」變成 AI 自己去看 Log，Debug 效率明顯提升。

5. Search Docs

避免 AI 使用錯版本 API。

Boost 的 Documentation API 有超過 17,000 筆 Laravel 生態系資訊，並根據專案實際安裝的套件版本提供對應文件（支援 Laravel 10~13、Filament 2~5、Livewire 1~4 等）。

---

五、Boost 不只是 MCP

如果只把 Laravel Boost 理解成「一個 Laravel MCP Server」，其實低估它了。

Boost 現在還提供：

• Guidelines：AI 啟動時就應該知道的通用規則（Laravel、Livewire、Pest、Tailwind 等）
• Skills：需要時才載入的專業知識（例如 Livewire Development、Pest Testing）
• Project Rules：真正適合企業專案的關鍵

Guidelines 是廣泛、基礎的規範；Skills 則是針對特定工作領域、需要時才啟用。

而 Project Rules 才是教 AI「你的公司系統怎麼寫」的地方。

例如：

• 所有 Permission 使用既有命名規則
• 不要自行新增 Repository
• 修改權限之前必須檢查 Policy / Gate / Shield / Permission Resolver
• 優先使用既有 Service
• 不要重複建立 Helper
• 修改資料庫之前必須先確認 migration

Boost 使用 .ai/rules/ 與 index.md，透過 glob 對應檔案範圍，讓 Agent 只讀取相關規則，而不是一次塞全部 Context。

甚至可以直接跟 Agent 說「記住：所有金額都使用 integer cents 儲存」，Boost 會透過 record-rule 工具把規則寫入 Project Rules。

---

六、對我來說，Boost 最大的價值

很多人看到 AI Coding 工具，第一個想法是「可以幫我寫 Code，所以會變快」。

但實際上，我認為更大的提升是：

減少 AI 與開發者之間反覆傳遞 Context 的時間。

沒有 Boost：

text

你：這是 Model。
AI：請給 migration。
你：這是 migration。
AI：請給 Service。
你：這是 Service。
AI：請給錯誤 Log。
你：這是 Log。

有 Boost：

text

你：找出這個問題並修正。
AI → Application Info → Database Schema → Code → Logs → Documentation → 修改

真正被加速的其實是 Context Gathering。

---

七、我自己的 AI 開發流程

如果是 Laravel 專案，我會要求 AI 遵循：

text

Think → Inspect → Understand → Plan → Modify → Verify

而不是：

text

Prompt → Generate Code

具體流程：

1. 先理解需求
2. 查看現有實作
3. 查看 Database Schema
4. 查看相關 Permission / Policy
5. 查官方文件
6. 提出最小修改方案
7. 修改
8. 查看 Log / Error
9. 測試
10. 檢查 Git Diff

Laravel Boost 剛好可以把其中很多 Context Gathering 的工作交給 Agent。

---

八、安全性提醒

Boost 能讓 AI 查 Database、執行 Query、讀 Logs，這不代表應該讓 AI 在 Production 隨便操作。

我會建議：

• Development → 完整 Boost
• Production → 嚴格限制

尤其是 UPDATE、DELETE、敏感資料、Payment、Authentication 都應該非常謹慎。

AI 工具越強，權限控管反而越重要。

另外，Boost 不是取代你的架構。我會在 Project Rules 明確寫：

• 不要過度設計
• 優先使用既有架構
• 修改前先搜尋現有實作
• 如果已有相同功能，禁止重新建立
• 只修改完成需求所必要的檔案
• 不要進行與需求無關的重構

---

九、結語：AI Coding 的下一步不是更大的模型，而是更好的 Context

使用 AI 一段時間後，我越來越覺得：

AI Coding 的瓶頸不一定是模型能力，而是 Context。

模型再強，如果它不知道你的 Laravel 版本、資料庫、套件、架構、權限、Log、Coding Convention，它還是可能寫出一段「看起來正確，但不適合你的專案」的 Code。

Laravel Boost 解決的，正是這個問題。

它把 Laravel + MCP + Documentation + Guidelines + Skills + Project Rules 組合起來，最後形成：

text

AI Agent
                       │
                  Laravel Boost
                       │
       ┌───────────────┼────────────────┐
       ↓               ↓                ↓
      MCP         Guidelines          Skills
       │               │                │
       └───────────────┼────────────────┘
                       ↓
                Laravel Application
                       │
        ┌──────────────┼───────────────┐
        ↓              ↓               ↓
      Code           Database         Logs

對我來說，Laravel Boost 最有價值的地方不是「讓 AI 幫我多寫幾行 Code」，而是：

讓 AI 從一個只會產生程式碼的工具，變成真正可以在 Laravel 專案裡工作的開發 Agent。

而這也讓 AI 開發的思維開始從：

text

Prompt → Code

慢慢變成：

text

Context → Understand → Plan → Code → Verify

這才是我認為 Laravel Boost 真正值得導入 Laravel 專案的原因。