Laravel MCP
Laravel 官方推出的 MCP 协议集成包，允许 Laravel 应用通过 Model Context Protocol 将工具、数据和提示模板暴露给 AI Agent 调用，支持细粒度权限控制和可搜索工具目录
核心事实
时间轴 (近 90 天)
建议把 inspector 测试作为开发流程中的固定步骤，在每次修改工具定义后先跑一遍，再接入真实客户端。
Laravel MCP 包单独生成 routes/ai.php 路由文件，与 web.php、api.php 隔离，以避免路由和安全策略互相污染。
Laravel MCP 提供 Mcp::web() 用于远程/生产环境注册服务器，Mcp::local() 用于本地开发注册服务器。
Laravel MCP 服务器类使用 #[Name]、#[Version]、#[Instructions] 属性，AI 客户端会读取这些属性来判断何时调用服务器。
#[IsReadOnly] 表示工具只读取数据、不产生副作用；#[IsIdempotent] 表示无论调用多少次结果相同；#[IsDestructive] 警告工具可能修改或删除数据。
php artisan mcp:inspector 启动的内置交互式会话本质上是一个内置 MCP 客户端，可按照协议规范发起握手、请求能力列表、展示工具 JSON Schema 并允许手动触发调用。
AI 模型读取工具类的 #[Description] 以及每个字段的 description 来决定如何调用工具，描述留空或过于笼统会明显提高调用失败率。
安全注解是向 AI 客户端传递风险等级的轻量级契约声明，不替代代码层面的权限校验，而是与之互补。
已经对外暴露给托管 AI 客户端时，必须使用 Mcp::web() 并考虑限流中间件；仅本机调试时 Mcp::local() 更简便。
Laravel MCP 官方包要求 PHP 8.2 以上版本和 Laravel 12.x 或 13.x。
还有 8 条时间轴事件
全部知识事实 (18)
通过执行 composer require laravel/mcp 一条命令即可将 Laravel MCP 接入应用
65%待验证建议把 inspector 测试作为开发流程中的固定步骤，在每次修改工具定义后先跑一遍，再接入真实客户端。
50%待验证Laravel MCP 提供 Mcp::web() 用于远程/生产环境注册服务器，Mcp::local() 用于本地开发注册服务器。
50%待验证Laravel MCP 服务器类使用 #[Name]、#[Version]、#[Instructions] 属性，AI 客户端会读取这些属性来判断何时调用服务器。
50%待验证#[IsReadOnly] 表示工具只读取数据、不产生副作用；#[IsIdempotent] 表示无论调用多少次结果相同；#[IsDestructive] 警告工具可能修改或删除数据。
50%待验证php artisan mcp:inspector 启动的内置交互式会话本质上是一个内置 MCP 客户端，可按照协议规范发起握手、请求能力列表、展示工具 JSON Schema 并允许手动触发调用。
50%待验证AI 模型读取工具类的 #[Description] 以及每个字段的 description 来决定如何调用工具，描述留空或过于笼统会明显提高调用失败率。
50%待验证安全注解是向 AI 客户端传递风险等级的轻量级契约声明，不替代代码层面的权限校验，而是与之互补。
50%待验证已经对外暴露给托管 AI 客户端时，必须使用 Mcp::web() 并考虑限流中间件；仅本机调试时 Mcp::local() 更简便。
50%待验证Laravel MCP 官方包要求 PHP 8.2 以上版本和 Laravel 12.x 或 13.x。
50%待验证Laravel MCP 包单独生成 routes/ai.php 路由文件，与 web.php、api.php 隔离，以避免路由和安全策略互相污染。
50%待验证Laravel MCP tool 的核心是 handle 方法，并通过 schema 和 outputSchema 两个方法约束 AI 的输入与输出，schema 定义参数及验证规则，outputSchema 定义返回数据结构
50%待验证原作者在一台 MCP 服务器上运行了 17 个工具，采用按需发现机制后节省了大量上下文空间
50%待验证Laravel MCP 1.0 版本带来了无状态服务器（stateless servers）支持
50%待验证Laravel MCP 可以把应用中的工具（tools）、数据（data）和提示（prompts）暴露给任意兼容 MCP 的 Agent 调用
50%待验证可搜索工具目录将上下文占用从 O(工具总数) 降低到 O(本次任务相关工具数)
50%待验证Laravel MCP 1.0 版本带来了更严格的 OAuth 认证机制
50%待验证Laravel 官方推出的 MCP（Model Context Protocol）包正式发布 1.0 稳定版
50%