Laravel MCP 是一份用于在 Laravel 中构建 MCP（Model Context Protocol）服务器的综合开发指南，主要面向需要将工具、提示词和资源暴露给 AI 客户端的开发者。
用途 该指南用于指导开发者创建 MCP 服务器（Web 或本地）、构建 AI 客户端可调用的工具、定义可复用的 AI 交互提示词、暴露资源作为 AI 上下文、使用 OAuth 或 Sanctum 保护 MCP 服务器，以及测试 MCP 服务器、工具、提示词和资源。
主要能力与规则分类 指南包含 5 个类别共 7 条规则，按优先级排列：
- 服务器（关键，前缀 server-）：server-create-register，创建并注册 Web 或本地 MCP 服务器。
- 工具（高，前缀 tool-）：tool-create，创建带输入/输出 schema、依赖注入和注解的工具；tool-responses，支持文本、错误、结构化、流式和多内容响应。
- 提示词与资源（中，前缀 prompt-、resource-）：prompt-create，创建带参数、验证和响应的提示词；resource-create，创建带 URI 模式的资源和资源模板。
- 认证（高，前缀 auth-）：auth-protect，使用 OAuth 2.1、Sanctum 或自定义认证保护服务器。
- 测试（高，前缀 test-）：test-unit，使用 MCP Inspector 和单元测试进行测试。
使用方式 开发者可阅读各规则文件获取详细说明和代码示例。每个规则文件包含：带元数据（标题、影响、标签）的 YAML frontmatter、为何重要的简要说明、带解释的反例、带解释的正例，以及 Laravel 13 和 PHP 8.3 特定上下文和参考。完整编译文档见 AGENTS.md。
核心代码模式 创建 MCP 服务器：继承 Laravel\Mcp\Server，使用 #[Name]、#[Version]、#[Instructions] 属性，并在 $tools、$resources、$prompts 数组中声明组件。 在 routes/ai.php 中注册：使用 Mcp::web('/mcp/weather', WeatherServer::class) 注册 Web 服务器，或 Mcp::local('weather', WeatherServer::class) 注册本地服务器。 创建工具：继承 Laravel\Mcp\Server\Tool，使用 #[Description] 属性，实现 handle(Request $request): Response 方法返回响应，并实现 schema(JsonSchema $schema): array 定义输入参数。
适用场景 适用于 Laravel 项目中需要与 AI 客户端集成的 MCP 服务器开发，包括暴露业务工具、定义提示词模板、提供资源上下文、配置认证保护以及编写测试。
限制 资料未提供具体的安装命令、依赖版本要求、收费或价格信息、平台支持范围以及实际运行效果说明，这些内容暂未提供。