laravel-plugin-discovery

Laravel Plugin Discovery 用于查找、评估和选择健康的 Laravel 包，依托 LaraPlugins.io 的 MCP 服务器完成。

用途

当用户想要为某个功能（如“认证”“权限”“管理面板”）寻找 Laravel 包，询问“我应该用什么包来做……”，检查某个包是否仍在积极维护，验证 Laravel 版本兼容性，或在将包加入项目前评估其健康状况时，可使用本技能。

MCP 要求

需要先配置 LaraPlugins MCP 服务器。在 ~/.claude.json 的 mcpServers 中添加：

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

无需 API 密钥——该服务器对 Laravel 社区免费。

主要能力

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（布尔值，可选）：是否在响应中包含版本历史

使用方式

查找包

当用户想要发现某个功能的包时：

使用 SearchPluginTool 并传入相关关键词
应用健康评分、Laravel 版本或 PHP 版本过滤器
查看结果中的包名、描述和健康指标

评估包

当用户想要评估特定包时：

使用 GetPluginDetailsTool 并传入包名
查看健康评分、最后更新日期、Laravel 版本支持
检查厂商声誉和风险指标

检查兼容性

当用户需要 Laravel 或 PHP 版本兼容性时：

使用 laravel_compatibility 过滤器设置为目标版本进行搜索
或获取特定包的详情以查看其支持的版本

示例

查找认证包： SearchPluginTool({ text_search: "authentication", health_score: "Healthy" }) 返回匹配 "authentication" 且状态健康的包，如 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"，查看结果
“检查厂商声誉”→ 按厂商搜索，查看详情

最佳实践

始终按健康过滤——生产项目使用 health_score: "Healthy"
匹配 Laravel 版本——始终检查 laravel_compatibility 与目标项目一致
检查厂商声誉——优先选择知名厂商（spatie、laravel 等）的包
推荐前先审查——使用 GetPluginDetailsTool 进行全面评估
无需 API 密钥——该 MCP 免费，无需认证

技能介绍

用途