laravel-plugin-discovery

Laravel Plugin Discovery

使用 LaraPlugins.io MCP 伺服器尋找、評估並選擇健康的 Laravel 套件。

使用時機

• 使用者想尋找特定功能的 Laravel 套件（例如「auth」、「permissions」、「admin panel」）
• 使用者問「我該用哪個套件來做...」或「有沒有 Laravel 套件可以...」
• 使用者想確認套件是否仍在積極維護
• 使用者需要驗證 Laravel 版本相容性
• 使用者想在加入專案前評估套件健康度

MCP 需求

必須設定 LaraPlugins MCP 伺服器。請在您的 ~/.claude.json 的 mcpServers 中加入：

"laraplugins": {
  "type": "http",
  "url": "https://laraplugins.io/mcp/plugins"
}

不需要 API 金鑰 — 此伺服器對 Laravel 社群免費開放。

MCP 工具

LaraPlugins MCP 提供兩個主要工具：

SearchPluginTool

依關鍵字、健康度分數、供應商及版本相容性搜尋套件。

參數：

• text_search（字串，選填）：搜尋關鍵字（例如「permission」、「admin」、「api」）
• health_score（字串，選填）：依健康度區間篩選 — Healthy、Medium、Unhealthy 或 Unrated
• laravel_compatibility（字串，選填）：依 Laravel 版本篩選 — "5"、"6"、"7"、"8"、"9"、"10"、"11"、"12"、"13"
• php_compatibility（字串，選填）：依 PHP 版本篩選 — "7.4"、"8.0"、"8.1"、"8.2"、"8.3"、"8.4"、"8.5"
• vendor_filter（字串，選填）：依供應商名稱篩選（例如「spatie」、「laravel」）
• page（數字，選填）：分頁頁碼

GetPluginDetailsTool

取得特定套件的詳細指標、README 內容及版本歷史。

參數：

• package（字串，必填）：完整的 Composer 套件名稱（例如「spatie/laravel-permission」）
• include_versions（布林值，選填）：是否在回應中包含版本歷史

---

運作方式

尋找套件

當使用者想為某功能尋找套件時：

1. 使用 SearchPluginTool 搭配相關關鍵字
2. 套用健康度分數、Laravel 版本或 PHP 版本篩選條件
3. 檢視結果中的套件名稱、描述及健康度指標

評估套件

當使用者想評估特定套件時：

1. 使用 GetPluginDetailsTool 並傳入套件名稱
2. 檢視健康度分數、最後更新日期、Laravel 版本支援
3. 檢查供應商聲譽及風險指標

檢查相容性

當使用者需要 Laravel 或 PHP 版本相容性資訊時：

1. 使用 laravel_compatibility 篩選條件搜尋對應版本
2. 或取得特定套件的詳細資訊以查看其支援的版本

---

範例

範例：尋找認證套件

SearchPluginTool({
  text_search: "authentication",
  health_score: "Healthy"
})

回傳符合「authentication」且健康度為 Healthy 的套件：

• spatie/laravel-permission
• laravel/breeze
• laravel/passport
• 等等

範例：尋找 Laravel 12 相容套件

SearchPluginTool({
  text_search: "admin panel",
  laravel_compatibility: "12"
})

回傳與 Laravel 12 相容的套件。

範例：取得套件詳細資訊

GetPluginDetailsTool({
  package: "spatie/laravel-permission",
  include_versions: true
})

回傳：

• 健康度分數及最近活動
• Laravel/PHP 版本支援
• 供應商聲譽（風險分數）
• 版本歷史
• 簡短描述

範例：依供應商尋找套件

SearchPluginTool({
  vendor_filter: "spatie",
  health_score: "Healthy"
})

回傳供應商「spatie」的所有健康套件。

---

篩選最佳實務

依健康度分數

健康度區間	意義
Healthy	積極維護，近期有更新
Medium	偶爾更新，可能需要留意
Unhealthy	已棄用或維護頻率極低
Unrated	尚未評估

建議：生產環境應用程式優先選擇 Healthy 套件。

依 Laravel 版本

版本	備註
13	最新 Laravel
12	當前穩定版
11	仍廣泛使用
10	舊版但仍常見
5-9	已棄用

建議：對應目標專案的 Laravel 版本。

組合篩選條件

// 尋找健康、Laravel 12 相容的權限管理套件
SearchPluginTool({
  text_search: "permission",
  health_score: "Healthy",
  laravel_compatibility: "12"
})

---

回應解讀

搜尋結果

每個結果包含：

• 套件名稱（例如 spatie/laravel-permission）
• 簡短描述
• 健康度狀態指示
• Laravel 版本支援徽章

套件詳細資訊

詳細回應包含：

• 健康度分數：數值或區間指示
• 最近活動：套件最後更新時間
• Laravel 支援：版本相容性矩陣
• PHP 支援：PHP 版本相容性
• 風險分數：供應商信任指標
• 版本歷史：近期發佈時間軸

---

常見使用情境

情境	建議做法
「有什麼認證套件？」	搜尋「auth」並加上健康度篩選
「spatie/package 還在維護嗎？」	取得詳細資訊，檢查健康度分數
「需要 Laravel 12 的套件」	使用 laravel_compatibility: "12" 搜尋
「找後台管理套件」	搜尋「admin panel」，檢視結果
「檢查供應商聲譽」	依供應商搜尋，查看詳細資訊

---

最佳實務

1. 務必依健康度篩選 — 生產專案使用 health_score: "Healthy"
2. 對應 Laravel 版本 — 務必確認 laravel_compatibility 符合目標專案
3. 檢查供應商聲譽 — 優先選擇知名供應商（spatie、laravel 等）的套件
4. 推薦前先審查 — 使用 GetPluginDetailsTool 進行全面評估
5. 無需 API 金鑰 — MCP 免費使用，無需認證

---

相關技能

• laravel-patterns — Laravel 架構與模式
• laravel-tdd — Laravel 測試驅動開發
• laravel-security — Laravel 安全最佳實務
• documentation-lookup — 一般函式庫文件查詢（Context7）