Laravel 插件发现¶

使用 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¶

按关键字、健康评分、vendor 和版本兼容性搜索包。

参数：

• 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（字符串，可选）：按 vendor 名称筛选（例如 “spatie”、“laravel”）
• page（数字，可选）：分页页码

GetPluginDetailsTool¶

获取特定包的详细指标、README 内容和版本历史。

参数：

• package（字符串，必填）：完整的 Composer 包名称（例如 “spatie/laravel-permission”）
• include_versions（布尔值，可选）：在响应中包含版本历史

工作原理¶

查找包¶

当用户希望为某个功能查找包时：

1. 使用 SearchPluginTool 并指定相关关键字
2. 应用健康评分、Laravel 版本或 PHP 版本筛选
3. 查看包含包名称、描述和健康指标的结果

评估包¶

当用户希望评估特定包时：

1. 使用 GetPluginDetailsTool 并传入包名称
2. 查看健康评分、最后更新日期、Laravel 版本支持情况
3. 检查 vendor 声誉和风险指标

检查兼容性¶

当用户需要 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 版本支持
• Vendor 声誉（风险评分）
• 版本历史
• 简要描述

示例：按 Vendor 查找包¶

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

返回 vendor “spatie” 的所有健康包。

筛选最佳实践¶

按健康评分¶

建议：生产环境应用优先选择 Healthy 包。

按 Laravel 版本¶

建议：匹配目标项目的 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 版本兼容性
• 风险评分：Vendor 信任指标
• 版本历史：近期发布时间线

常见用例¶

最佳实践¶

1. 始终按健康情况筛选 — 生产项目使用 health_score: "Healthy"
2. 匹配 Laravel 版本 — 始终确保 laravel_compatibility 与目标项目匹配
3. 检查 vendor 声誉 — 优先选择来自知名 vendor（spatie、laravel 等）的包
4. 推荐前先审查 — 使用 GetPluginDetailsTool 进行全面评估
5. 无需 API 密钥 — MCP 免费，无需身份验证

相关技能¶

• laravel-patterns — Laravel 架构与模式
• laravel-tdd — Laravel 测试驱动开发
• laravel-security — Laravel 安全最佳实践
• documentation-lookup — 通用库文档查询（Context7）