> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel 与 AI 开发

> Laravel 是最适合 AI 辅助开发的框架之一。通过 Laravel Boost 的 MCP 服务器集成、AI 指南与文档搜索 API，充分发挥 AI 编码代理的能力。

## 为什么 Laravel 适合 AI 开发

[Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Cursor](https://cursor.com)、[GitHub Copilot](https://github.com/features/copilot) 等 AI 编码代理能极大加速代码生成、调试和重构。但要充分发挥代理的能力，它们必须能精确理解代码库。

在这方面 Laravel 相对其他框架具有优势。得益于基于约定的设计，让代理「添加一个控制器」，它就知道该放在哪里；让它「创建迁移」，它也能预测命名规则和文件位置。这种一致性消除了让 AI 工具感到困惑的「歧义」。

Eloquent 关系、Form Request、中间件等特性都遵循代理能够可靠理解并复现的模式。最终生成的代码不再是零散 PHP 片段的堆砌，而是像资深 Laravel 开发者一样地道。

## Laravel Boost

[Laravel Boost](https://github.com/laravel/boost) 是一个桥接 AI 编码代理和 Laravel 应用的包。Boost 作为 **MCP（Model Context Protocol）服务器** 运行，通过 15 个以上的专用工具让代理深入理解应用的结构、数据库、路由等。

Boost 提供三大核心功能：

<Columns>
  <Card title="MCP 工具集" icon="wrench">
    用于检查和操作应用的 15+ 工具。从查看数据库结构到运行 Artisan 命令都能胜任。
  </Card>

  <Card title="AI 指南" icon="book-open">
    针对 Laravel 生态设计的 AI 指南，把编写地道代码的最佳实践传达给代理。
  </Card>

  <Card title="文档搜索 API" icon="magnifying-glass">
    搜索 17,000+ 条 Laravel 专属文档，能根据已安装包的版本提供准确信息。
  </Card>
</Columns>

### 安装

Boost 支持 Laravel 10、11、12、13 与 PHP 8.1 及以上。首先作为开发依赖引入：

<Steps>
  <Step title="安装包">
    ```shell theme={null}
    composer require laravel/boost --dev
    ```
  </Step>

  <Step title="运行交互式安装器">
    ```shell theme={null}
    php artisan boost:install
    ```

    安装器会自动检测 IDE 与 AI 代理。选择要使用的集成后，会生成 MCP 服务器的 `.mcp.json` 与指南文件等所需配置。
  </Step>
</Steps>

<Info>
  如果希望每位开发者各自配置环境，可以将 `.mcp.json`、`CLAUDE.md`、`boost.json` 等生成的文件加入 `.gitignore`。
</Info>

### 可用的 MCP 工具

Boost 向代理公开的工具包括：

| 工具         | 说明                                    |
| ---------- | ------------------------------------- |
| 应用检查       | 查看 PHP 与 Laravel 版本、已安装包、配置及环境变量      |
| 数据库工具      | 查看结构、执行只读查询、了解数据结构                    |
| 路由检查       | 列出所有已注册路由，包含中间件、控制器、参数                |
| Artisan 命令 | 探索可用 Artisan 命令与参数，代理可提议或执行合适命令       |
| 日志分析       | 读取并分析应用日志，辅助调试                        |
| 浏览器日志      | 借助 Laravel 前端工具访问浏览器控制台日志与错误          |
| Tinker 集成  | 通过 Laravel Tinker 在应用上下文中运行 PHP 并验证行为 |
| 文档搜索       | 按已安装包版本搜索 Laravel 生态文档                |

### AI 指南

Boost 的 AI 指南是针对 Laravel 生态设计的编码规范合集。它将地道 Laravel 代码写法、框架约定、避免常见陷阱的技巧传达给代理。指南会根据已安装包的版本自动组合。

支持的包示例：

* Livewire（2.x、3.x、4.x）
* Inertia.js（React / Svelte / Vue 变体）
* Tailwind CSS（3.x、4.x）
* Filament（3.x、4.x）
* PHPUnit、Pest PHP、Laravel Pint 等

运行 `boost:install` 时会依据 `composer.json` 自动检测当前使用的包，并把相关指南写入 AI 上下文文件。

### Agent Skills

[Agent Skills](https://agentskills.io/home) 是代理在需要时按需加载的轻量知识模块。与一开始就加载整体指南不同，只有在特定领域工作时才启用相关技能。它避免了上下文膨胀，提升生成代码的准确性。

已提供针对 Livewire、Inertia、Tailwind CSS、Pest 等热门包的 Skills。若在 `boost:install` 中选择了该功能，将基于 `composer.json` 自动安装。

### 文档搜索 API

Boost 的文档 API 让代理能够搜索 17,000+ 条 Laravel 生态文档。与通用网页搜索不同，它是按已安装包版本索引并向量化的。

代理在探究某功能实现时，可以调用该 API 获得版本对应的准确信息，从而避免代理推荐旧版本已弃用方法或语法的问题。

### 支持的代理

Boost 支持所有主流具备 Model Context Protocol 能力的 IDE 与 AI 工具：

<Columns>
  <Card title="Cursor" icon="arrow-pointer" href="https://cursor.com" />

  <Card title="Claude Code" icon="terminal" href="https://docs.anthropic.com/en/docs/claude-code" />

  <Card title="GitHub Copilot" icon="github" href="https://github.com/features/copilot" />

  <Card title="Gemini CLI" icon="arrow-right" href="https://github.com/google-gemini/gemini-cli" />

  <Card title="Codex" icon="arrow-right" href="https://openai.com/codex" />

  <Card title="Junie" icon="arrow-right" href="https://www.jetbrains.com/junie/" />
</Columns>

关于各代理的详细配置步骤，请参阅 [Boost 文档中的「Set Up Your Agents」](https://laravel.com/docs/boost#set-up-your-agents)。

## 下一步

<Card title="Laravel Boost 官方文档" icon="book-open-cover" href="https://laravel.com/docs/boost">
  关于各代理的详细集成方式、MCP 工具参考以及指南的自定义，请查阅官方文档。
</Card>


## Related topics

- [Laravel MCP](/zh/mcp.md)
- [Laravel 包开发](/zh/advanced/package-development.md)
- [Laravel Boost](/zh/boost.md)
- [Laravel PAO — 面向 AI 智能体的输出优化工具](/zh/blog/pao-introduction.md)
- [创建 AI SDK 的自定义 Provider](/zh/advanced/ai-sdk-custom-provider.md)