laravel-plugin-discovery

Laravel 插件发现

使用 LaraPlugins.io MCP 服务器查找、评估和选择健康的 Laravel 扩展包。

何时使用

• 用户想要查找特定功能的 Laravel 扩展包（例如"认证"、"权限"、"管理面板"）
• 用户询问"我应该用什么包来做..."或"有没有 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"加 healthy 过滤
"spatie/xxx 还在维护吗？"	获取详情，检查健康评分
"需要 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）