2026-05-11 14:38:12 -04:00

5.9 KiB
Raw Blame History

name, description, origin
name description origin
laravel-plugin-discovery 通过LaraPlugins.io MCP发现和评估Laravel包。当用户想要查找插件、检查包的健康状况或评估Laravel/PHP兼容性时使用。 ECC

Laravel 插件发现

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

使用时机

  • 用户想为特定功能(如 "auth"、"permissions"、"admin panel")寻找 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 (字符串,可选):按健康等级筛选——HealthyMediumUnhealthyUnrated
  • 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" 且状态健康的包:

  • 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 版本。

组合筛选条件

// Find healthy, Laravel 12 compatible packages for permissions
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