Laravel Boostとは？2系のMCPツール10種と対応エディタ・laravel/mcpとの違い

Laravel Boostは、Laravel公式が配布しているAIコーディング支援用のdevパッケージ（laravel/boost）です。Claude Code・Cursor・GitHub CopilotなどのAIエージェントに、アプリ固有の情報を返すMCPサーバーと、Laravelの書き方を教えるガイドライン・Skillsをまとめて配ります。最新版はv2.10.1（2026年10月1日公開）で、既定で有効なMCPツールは10種です。初期の解説記事に多い「16のツール」はv1.0時点の数で、現在は当てはまりません。

この記事では、Boostの全体像・MCPツール・対応エディタ・バージョン履歴を解説します。boost:installで聞かれる質問への答え方やSkillsの運用はLaravel Boostの使い方｜boost:installの選択肢とSkills・エージェント別設定で手順として解説しています。記載内容はlaravel/boost v2.10.1のソースと公式ドキュメント（13.x）で確認しました。

まとめ：Laravel Boostの最新バージョンと要点

• 最新版はv2.10.1（2026年10月1日）。2系は2026年1月24日のv2.0.0から始まり、その後のマイナー版は不定期に公開されている。
• 中身はMCPサーバー・AIガイドライン・Agent Skillsの3つ。composer require laravel/boost --dev と php artisan boost:install で入る。
• 既定で有効なMCPツールは10種で、PHPを実行するTinkerは設定で有効にしたときだけ加わる。v2.3.0でArtisanコマンドのラッパー系ツールが削除され、エージェントにはCLIを直接使わせる方針に変わった。
• 要件はPHP 8.2以上と、Laravel 11.45.3以上・12.41.1以上・13系。PHP 8.1やLaravel 10が対象だったのは1.x系の話。
• BoostはAPP_ENVがlocal、またはAPP_DEBUGがtrueの環境でだけ起動する。本番ではdev依存ごと外す。
• 「laravel mcp」で探しているのが自分のアプリをMCPサーバーとして公開する方法なら、使うのはBoostではなくlaravel/mcpパッケージ。

Laravel Boostとlaravel/mcpの関係と使い分け

「Laravel MCP」と呼ばれるものは2つあります。Boostは開発中のAIエージェントに自分のプロジェクトを読ませるための完成品です。laravel/mcpはMCPサーバーを自作するためのフレームワークで、Boost自身もその上に作られています（Boostのcomposer.jsonは laravel/mcp の ^0.7.1〜^1.0 を要求）。

社内のAIエージェントから受注データや在庫を引けるようにしたい、という要件ならlaravel/mcpで専用サーバーを作ります。Boostは開発支援用のSTDIOサーバーで、業務データを外部クライアントへ提供するHTTPサーバー用途には適しません。MCPそのものの仕組みはMCPとは？AIと外部ツールをつなぐ標準規格とMCPサーバーの仕組み・作り方を解説で整理しています。

laravel/mcpでMCPサーバーを作る最小構成

laravel/mcpは2026年9月14日に1.0.0が出て、APIが安定版になりました。要件はBoostと同じくPHP 8.2以上・Laravel 11.45.3以上です。最小構成は、サーバークラス1つ・ツールクラス1つ・routes/ai.phpへの登録1行です。

composer require laravel/mcp
php artisan vendor:publish --tag=ai-routes
php artisan make:mcp-server WeatherServer
php artisan make:mcp-tool CurrentWeatherTool

生成されたサーバークラスの $tools 配列にツールを足し、routes/ai.php で公開方法を選びます。次のHTTP例は、Sanctumの導入・認証設定と、RateLimiter::for('mcp', ...) による名前付きレートリミッターの定義が済んでいる前提です。Inspectorから接続する際にも、有効な認証トークンを指定します。

use App\Mcp\Servers\WeatherServer;
use Laravel\Mcp\Facades\Mcp;

// HTTP（POST）で公開。通常のルートと同じくミドルウェアを掛けられる
Mcp::web('/mcp/weather', WeatherServer::class)
    ->middleware(['auth:sanctum', 'throttle:mcp']);

// ローカル用（Artisanコマンドとして起動。Boostと同じ方式）
Mcp::local('weather', WeatherServer::class);

ツール名は、#[Name] 属性で指定しない限りクラス名をケバブケースにしたものになります。上の例では current-weather-tool で、末尾の「Tool」も名前に残ります。動作確認は php artisan mcp:inspector mcp/weather（ローカル用なら mcp:inspector weather）で、MCP Inspectorからツールを呼べます。認証方式は、公式ドキュメントがOAuth 2.1（Passport）とSanctumの2通りを案内しています。

Boostが配る3つの仕組みと役割の違い

Boostを入れると、エージェントには性質の違う3種類の情報が届きます。同じ「AIにLaravelを教える」でも、効く場面が違います。

ガイドラインとSkillsは「書き方」、MCPは「このアプリの今の状態」を担当します。たとえばテーブル定義を推測で書かれる問題はMCPの database-schema で、古い書き方を提案される問題はガイドラインとドキュメント検索で防ぎます。Skillsの種類と自作方法はLaravel Boostの使い方の「Guidelines・Skills・Project Rulesの使い分け」で扱っています。

MCPツール10種の一覧と用途

v2.10.1の src/Mcp/Boost.php には11種のツールが並んでいますが、tinker だけは既定で無効です。Laravel 13.34.0の新規プロジェクトにv2.10.1を入れ、php artisan boost:mcp にMCPの tools/list を送ると、返ってきたのは次表のうちtinkerを除く10種でした（2026年10月1日）。Record RuleとTinker以外には、読み取り専用（IsReadOnly）の注釈が付いています。

database-query はSELECT・SHOW・EXPLAIN・DESCRIBE・DESC・WITH…SELECTに加え、VALUES・TABLEも許可候補に含めます。さらに複文や書き込み構文を検査し、実行時にはDB側の読み取り専用設定とトランザクションのロールバックを組み合わせます。DELETE FROM users を送ると「Only read-only queries are allowed」で止まりました。一方 tinker はPHPを実行できるので、Eloquent経由ならデータを書き換えられます。そのため既定では登録されず、config/boost.php に 'tinker_tool_enabled' => true を書いたときだけ公開されます。逆に既定のツールを止めたいときは、同じファイルの mcp.tools.exclude にクラス名を書きます。

ツールのほかに、MCPのプロンプトが5つ入っています。Laravel 13・Livewire 4・Inertia 3・Laravel AI SDK 1.0へのアップグレード手順と、コードを簡潔にするLaravel Code Simplifierです。表示条件はプロンプトごとに異なります。AI SDK用にはパッケージ・版による登録条件がなく、Livewire用とInertia用は対象パッケージの有無で、Laravel 13用はLaravel 12を使っているかで判定されます。

BoostのMCPツール数の変遷と既定有効数

Boostのツールは減ってきています。v1.0.0はツール用ディレクトリのクラスを全部登録する方式で、16種ありました。v2.0.0で登録が明示的な列挙に変わって15種になり、v2.3.0（2026年3月11日）で大きく削られました。

v2.3.0で消えたのは、Get Config・List Artisan Commands・List Available Config Keys・List Available Env Vars・List Routesの5種です。変更のPR名は「Remove Artisan wrapper MCP tools and update guidelines to use CLI directly」で、php artisan route:list などは、エージェントにシェルから直接実行させる方針に切り替わりました。旧記事や旧版の解説にある「ルート一覧ツール」「設定値の照会ツール」を前提にMCPクライアント側の許可設定を組んでいると、該当ツールが存在しないことになります。

公式ドキュメント13.xのツール一覧表も10行で、Tinkerは載っていません。既定で無効なためです。旧版の解説を見て「Tinkerで動作確認させる」前提を組んでいるなら、設定で有効にするか、エージェントにシェルから php artisan tinker を使わせます。

search-docsツールが参照するドキュメントAPIと版の絞り込み

search-docs は、Laravelがホストする https://boost.laravel.com/api/docs に問い合わせます。公式ドキュメントによれば、収録は17,000件を超えるLaravel固有の情報で、埋め込みによるセマンティック検索です。

このツールの要点は、版の絞り込みです。プロジェクトに入っているパッケージを集めて「13.x」「4.x」のようにメジャー版単位で送るため、Laravel 11のプロジェクトでLaravel 13の新APIを提案される、といった取り違えが起きにくくなります。返す量は既定で3,000トークンです。逆に、対象外のパッケージや、マイナー版で入った新機能の細部は拾えないことがあります。

対応エディタ・AIエージェント13種とMCP設定ファイル

v2.10.1が対応するエージェントは、Amp・Antigravity・Claude Code・Codex・GitHub Copilot・Cursor・Factory Droid・Grok Build・Junie・Kiro・OpenCode・Pi・Zedの13種です。Boostが対応しているのはエディタではなくエージェントです。エディタ名で探す場合は、そのエディタで使うエージェントを boost:install で選びます。

VS Code（GitHub Copilot）での接続

VS CodeのCopilotでは、boost:install でGitHub Copilotを選ぶと .vscode/mcp.json にサーバー定義が書かれます。自動では起動しないので、コマンドパレットの「MCP: List Servers」から laravel-boost を選び「Start server」を押します。VS CodeでClaude CodeやCodexの拡張を使っている場合は、Copilotでなく各エージェントを選びます。ガイドラインはAGENTS.md、Skillsは .github/skills に入ります。

PhpStorm（Junie）での接続

PhpStormではJetBrainsのエージェントJunieを選びます。生成された .junie/mcp/mcp.json は、Shiftキー2回で開くコマンドパレットから「MCP Settings」を開き、laravel-boost にチェックを入れて「Apply」で有効になります。PhpStormでClaude CodeやCodexのCLIを使っているなら、それぞれのエージェントを選んでください。

Cursor・Claude Code・Codexでの接続

Cursorはコマンドパレットの「/open MCP Settings」で laravel-boost のトグルをオンにします。Claude CodeとCodexの接続設定は通常自動で生成されます。ただしClaude Codeの対話セッションでは、初回にプロジェクトのMCPサーバー利用を承認する必要があります。接続できない場合は承認状態と設定を確認し、未登録の場合に手動で追加します。

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

# Codex
codex mcp add laravel-boost -- php "artisan" "boost:mcp"

v2.10.0から、Claude Code向けのガイドラインはAGENTS.mdに書かれるようになりました。プロジェクトにCLAUDE.mdが既にある場合は、引き続きCLAUDE.mdが更新されます。エージェント別の生成ファイルや、つながらないときの切り分けはLaravel Boostの使い方にまとめています。Claude Code自体の導入はClaude Codeの使い方｜導入から権限とCLAUDE.md設定まで実務手順を参照してください。

動作要件と起動する環境の条件

v2.10.1のcomposer.jsonが求める要件は次のとおりです。旧版の解説に多い「PHP 8.1以上・Laravel 10〜12」「ベータ版」は1.x系の記述で、2系には当てはまりません。

Laravel 13はフレームワーク自体がPHP 8.3以上を要求するので、Boost単体の「8.2以上」より厳しくなります。プロジェクトの版の確かめ方はLaravelのバージョン確認｜artisanとcomposerの違いとサポート期限で説明しています。

Boostのサービスプロバイダーは、BOOST_ENABLED がfalseでなく、かつAPP_ENVがlocalかAPP_DEBUGがtrueのときだけMCPサーバーとArtisanコマンドを登録します。裏を返すと、APP_ENV=productionでもAPP_DEBUG=trueならBoostは有効になります。--dev で入れ、本番デプロイは composer install --no-dev で行うのが前提です。

バージョン履歴：1.0から2.10までの主な変更

2系はマイナー版の間隔が短く、2026年8月以降だけでv2.5.0からv2.10.1まで出ています。移行手順はLaravel Boostの使い方の「1.xから2.xへのアップグレード手順」で扱っています。

インストール済みバージョンの確認と更新手順

手元のBoostの版は、Composerで確認します。Boostには版を表示するArtisanコマンドがありません。

# インストール済みの版
composer show laravel/boost | grep versions

# composer.jsonのバージョン制約内で更新する
composer update laravel/boost

# ガイドラインとSkillsを新しい版の内容で作り直す
php artisan boost:update

composer update だけでは、生成済みのAGENTS.mdやSkillsは古いままです。boost:update まで実行して初めて、新しい版のガイドラインが反映されます。Composerの post-update-cmd に @php artisan boost:update --ansi を登録しておくと、パッケージ更新のたびに自動で走ります。boost:update のオプションと、MCP設定を作り直す条件はLaravel Boostの使い方で解説しています。

Boostで足りる場面とlaravel/mcpで自作すべき場面

判断基準は「誰がMCPを呼ぶか」です。呼ぶのが自分のエディタのエージェントで、目的がLaravelのコードを正しく書かせることなら、Boostで足ります。自作のMCPツールを足したくなっても、まず config/boost.php の mcp.tools.include に自作のToolクラスを追加する方法を試すべきです。Boostのサーバーにそのまま相乗りできます。

逆に、次のどれかに当てはまるならBoostは候補から外し、laravel/mcpで専用サーバーを作ります。

• 社外や他部署のAIクライアントから呼ばせる（BoostはSTDIO専用で、HTTPの口を持たない）
• 本番のデータや業務処理をツールとして公開する（Boostは開発支援用で、本番への導入を避ける）
• 利用者ごとに認証・権限を分ける（laravel/mcpならSanctumやPassportのミドルウェアを掛けられる）

Boostのツールを本番に向けて動かす目的でAPP_DEBUG=trueにするのは、最もやってはいけない使い方です。既定のツールだけでも database-query で本番データを読めるうえ、Tinkerを有効にしていれば任意のPHPを実行できる口を本番環境に開けることになるからです。Laravel 13のAI機能全体を見渡すなら、Laravel 13のAI SDK入門｜導入手順・Agent実装・ベクトル検索の要件も判断材料になります。

よくある質問

Laravel Boostは無料で使えますか？

無料です。laravel/boostはMITライセンスのオープンソースで、GitHubの laravel/boost リポジトリで公開されています。ドキュメント検索で使うboost.laravel.comのAPIにも、利用料やAPIキーの設定は要りません。費用がかかるのは、接続するAIエージェント側の利用料です。

Laravel 10のプロジェクトでもLaravel Boostは使えますか？

2系は使えません。v2.0.0でLaravel 11（11.45.3以上）とPHP 8.2が下限になりました。Laravel 10.49.0以上なら1.x系は入りますが、Agent Skillsなど2系の機能は使えません。移行先は、セキュリティサポート中のLaravel 12または13を選んでください。Laravel 11は2026年3月12日にセキュリティサポートが終了しています。

Laravel Boostは本番環境で動きますか？

APP_ENVがlocalでもなく、APP_DEBUGもfalseなら、MCPサーバーもArtisanコマンドも登録されません。ただし本番でもAPP_DEBUGがtrueだと有効になるため、--dev で入れて本番には含めない運用が前提です。

Laravel BoostのMCPサーバーは何で起動しますか？

php artisan boost:mcp です。エディタやエージェントが、このコマンドをSTDIOで起動します。手動で登録するときは、コマンドに php、引数に artisan boost:mcp を指定します。

Laravel MCPとLaravel Boostはどちらを入れればよいですか？

手元のAIエージェントにLaravelのコードを書かせたいならBoostです。BoostをComposerで入れると、laravel/mcpも依存として一緒に入ります。自分のアプリの機能を外部のAIクライアントへMCPで公開したい場合は、laravel/mcpを直接使ってサーバーを作ります。

関連記事

• Laravel Boostの使い方｜boost:installの選択肢とSkills・エージェント別設定
• MCPとは？AIと外部ツールをつなぐ標準規格とMCPサーバーの仕組み・作り方を解説
• Laravel 13のAI SDK入門｜導入手順・Agent実装・ベクトル検索の要件
• Laravelのバージョン確認｜artisanとcomposerの違いとサポート期限
• Claude Codeの使い方｜導入から権限とCLAUDE.md設定まで実務手順