2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Laravel開発者がAIエージェントを「本物のLaravel専門家」に変える方法 — Laravel Boost完全ガイド

2
Posted at

AIコーディングエージェントが「それっぽいPHP」を書く時代は終わりました。
今、Laravel開発者は「自分のプロジェクトを正確に理解したLaravelの専門家」を手元に置くことができます。

その名も Laravel Boost

Laravel公式が作った、AIエージェント専用のMCPサーバーです。

この記事では、Laravel Boostの導入から実際の使い方、現場で効くTipsまでを、できるだけわかりやすく解説します。


なぜLaravel Boostが必要なのか?

AIコーディングエージェント(Cursor、Claude Code、GitHub Copilotなど)は非常に強力です。
しかし、Laravelプロジェクトではよくこんなことが起きます:

  • 古いAPIを平気で使う
  • プロジェクトの実際のスキーマを無視する
  • LivewireやInertiaのバージョンを間違える
  • テストを書かない、または書き方が違う
  • 「それっぽいけど実際には動かない」コードを量産する

これはAIが「一般的なPHPの知識」しか持っていないからです。

Laravel Boostはこの問題を根本から解決します。

Boostを入れると、AIエージェントは以下のことができるようになります:

  • プロジェクトの実際のDBスキーマを読む
  • Tinkerでコードを実行して確認する
  • インストールされているパッケージのバージョンに合わせたドキュメントを検索する
  • Laravelのベストプラクティスとプロジェクトの慣習に沿ったコードを書く

結果として、「修正が少なくて済む」「レビューしやすい」コードが出てきます。


Laravel Boostとは何か?

Laravel Boostは公式のComposerパッケージで、以下の3つを提供します:

  1. Laravel専用MCPサーバー(15以上のツール)
  2. バージョン対応のAIガイドライン(コンポーザブル)
  3. 17,000以上のLaravelエコシステムドキュメントを持つ検索API

要するに、「AIエージェントにLaravelの文脈とプロジェクトの文脈を与える」ためのツールです。

対応環境:

  • Laravel 10 / 11 / 12+
  • PHP 8.1以上

インストール手順(2分で完了)

composer require laravel/boost --dev
php artisan boost:install

boost:install は対話式です。
使用しているエディタ(Cursor / Claude Code / PhpStormなど)を自動検出して、必要な設定ファイルを生成してくれます。

生成される主なファイル:

  • .mcp.json
  • CLAUDE.mdAGENTS.md
  • .cursor/rules/ 配下のガイドライン
  • boost.json

これらは .gitignore に追加しておくのがおすすめです(再生成されるため)。

エディタごとの有効化

Cursorの場合

  1. Cmd + Shift + P(または Ctrl + Shift + P
  2. 「MCP Settings」を開く
  3. laravel-boost をオンにする

Claude Codeの場合

claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp

他のツール(PhpStorm、GitHub Copilot、Gemini CLIなど)も同様に簡単に設定できます。


実際に使える15以上のツール

Boostが提供する主なツールは以下の通りです:

ツール名 できること
Application Info PHP・Laravelバージョン、インストールパッケージ、Eloquentモデルを取得
Database Schema 全テーブルのスキーマを読み取る
Database Query 実際のDBにクエリを投げる(主に読み取り)
List Routes ルート一覧とミドルウェアを確認
Tinker アプリケーションコンテキストでPHPコードを実行
Search Docs インストール済みパッケージのバージョンに合わせたドキュメント検索
Last Error / Read Log Entries 最新のエラーやログを読む
Browser Logs ブラウザのコンソールエラーを取得
List Artisan Commands 利用可能なArtisanコマンドを確認

AIはこれらのツールを自動で呼び出します。
あなたは普通に「Userモデルにactiveスコープを追加して」と頼むだけで大丈夫です。


実際の使い方例

例1:モデルにスコープを追加する

プロンプト例:

Userモデルにactiveスコープを追加して。statusがactiveのものだけを取得できるようにして。

BoostありだとAIは:

  1. Application Info / Database Schemaで現状を確認
  2. 既存のモデルの書き方を参考にする
  3. 正しいLaravelの書き方でスコープを追加
  4. 必要ならテストも提案

例2:ホワイトスクリーンを直す

プロンプト例:

ユーザー一覧でホワイトスクリーンが出る。原因を調べて直して。

AIは:

  • Last Errorを読む
  • Browser Logsを確認
  • 関連するコントローラーやビューを調査
  • 修正案を提示

例3:InertiaやLivewireの正しい書き方をさせる

Boostはインストールされているバージョンを見て、正しいAPIを使わせます。
古い書き方を提案しにくくなります。


GuidelinesとSkillsの違い

  • Guidelines:最初から常に読み込まれる基本ルール(Laravelの慣習など)
  • Skills:必要なときだけ読み込まれる詳細な知識(Livewire、Pest、Inertiaなど)

この仕組みのおかげで、コンテキストが無駄に膨らまず、精度が上がります。

カスタムのガイドラインやスキルも簡単に追加できます。


運用Tips

  1. 定期的に更新する

    php artisan boost:update
    

    Composerのpost-update-cmdに入れておくと便利です。

  2. プロジェクトの目的を教えてあげる
    configにアプリの概要を書いておくと、AIの理解度がさらに上がります。

  3. 生成されたコードは必ずレビューする
    Boostは強力ですが、最終判断は人間が行うべきです。

  4. フィードバックを送る
    Boostには「Report Feedback」ツールがあります。
    「このツールが役に立った」「ここがおかしい」とAIに伝えるだけで、Laravelチームに届きます。


まとめ

Laravel Boostを入れると、AIエージェントが「一般的なPHPアシスタント」から「あなたのプロジェクトを理解したLaravel開発者」に変わります。

  • インストールは2コマンド
  • 設定もほぼ自動
  • ツールが豊富で実用的
  • 公式がメンテナンスしている

まだ入れてない人は、今日中に試してみてください。
一度使うと、もうBoostなしのAIには戻れなくなります。


参考リンク

質問や「こんな使い方してるよ」という報告があれば、ぜひコメントで教えてください!


補足(あなた向け)

  • タイトルはクリックされやすいように「2026最新」「完全ガイド」を入れています。
  • 導入部分で「痛み」を明確に書いてから解決策を出す構成にしています。
  • 表やコードブロックを多用して読みやすくしています。
  • 最後に行動を促す締めにしています。

もしベトナム語版英語版も欲しい、または特定の部分を強調・短縮したい場合は教えてください。すぐに調整します。

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?