用途:该技能面向 Laravel 项目的 MCP(Model Context Protocol)开发,在创建或编辑 MCP 工具、资源、提示、服务器或 UI 应用时触发。可先用 search-docs 查询 Laravel MCP 的详细模式与文档;涉及 MCP UI 应用(交互式 HTML 资源)时,需阅读 references/app.md,其中涵盖整体架构、宿主主题 CSS 变量、工具与 UI 的关联模式、库脚本(通过 Library 使用 Tailwind、Alpine)及实际示例。
主要能力与用法:在 routes/ai.php 中注册 MCP 服务器,例如 Mcp::web('/mcp/demo', \App\Mcp\Servers\AppServer::class)。使用 Artisan 命令创建原语:php artisan make:mcp-tool ToolName、php artisan make:mcp-resource ResourceName、php artisan make:mcp-prompt PromptName、php artisan make:mcp-server ServerName、php artisan make:mcp-app-resource DashboardApp(生成两个文件)。创建后需在服务器的 $tools、$resources、$prompts 属性中注册。工具类继承 Tool,定义 $description、schema(JsonSchema) 与 handle(Request) 方法,可校验请求并返回 Response::text 等响应。
验证与限制:检查 routes/ai.php 是否正确注册,并通过 MCP 客户端测试工具。常见问题包括运行 mcp:start 命令会挂起等待输入、本地对基于 Node 的 MCP 客户端使用 HTTPS、未使用 search-docs 获取最新文档、未在 routes/ai.php 注册服务器路由;不要在 bootstrap.php 中注册 ai.php,它会自动注册。OAuth 注册通过 mcp.custom_schemes 配置支持自定义 URI 方案(如 cursor://、vscode://)以适配原生桌面客户端。