Laravel Codebase Introspection and Analysis

Laravel コードベースの把握とイントロスペクションのための MCP サーバー

AI がコードベースを理解するには、その中に何があるのかを把握できる必要があります。 ベクトル検索はコード検索に強力なツールですが、多くのトークンを消費し、ビューやルートなど、コードベース全体を把握することもできません。 このパッケージは、mateffy/laravel-introspect パッケージ用の Model Context Protocol（MCP）サーバーを実装しています。コードベースをイントロスペクションし、構造化された情報を取得できます。

• 🔍 コード全体を読み込まなくても、AI がビュー、ルート、クラス、モデルを照会できます
• 🔍 ワイルドカード（*）を使って、複数のビュー、ルート、クラス、モデルを照合することもできます
• 🔍 多くのファイル検索ツールでは対応できない、Laravel パッケージ内の項目の照会にも対応しています
• 🪄 データモデルとそのリレーションシップの概要を AI にすばやく提供します
• 🤖 MCP プロトコルを実装するあらゆる AI エージェントに対応しています

クエリ	利用可能なフィルター
ビュー	名前、パス、使用しているビュー、使用されているビュー、継承元
ルート	名前、URI、コントローラー + fn、メソッド、ミドルウェア
クラス	名前／名前空間、親クラス、実装インターフェース、使用トレイト
⤷ モデル	... リレーションシップ、プロパティ、キャスト、fillable、hidden、読み書き可能
⤷ コマンド	... シグネチャ、説明（近日公開）

名前やその他いくつかのクエリでは、ワイルドカードを使った照会にも対応しています（例：components.*.paragraph）

対象ユーザー

Aider、Cursor、Windsurf、Claude Code などの AI ツールをアプリ開発に利用している方に、このパッケージは最適です。 エージェントに MCP サーバーを設定するだけで、ビュー、ルート、クラス、モデルをコードベースから自動的に照会できるようになります。

特に、コードを検索するだけでは実用的でない大規模なコードベースで役立ちます。

タスクの例

• AI にデータモデルとそのリレーションシップの概要を提示する
• ビューをリファクタリングし、ほかの場所で使われていないことを確認する
• 特定のコントローラーを使用するすべてのルートを探す
• 特定のトレイトやインターフェースを使用するモデルを探す
• すべてのルートで正しいミドルウェアが使われていることを確認する

laravel-codebase-mcp と laravel-introspect の比較

MCP サーバーは、コードベースをイントロスペクションし、構造化された情報を取得するために laravel-introspect パッケージを使用します。 テストを作成したり、同じクエリを複数回実行したりする場合は、パッケージを直接使用することもできます。

## インストール

composer からパッケージをインストールします。

composer require mateffy/laravel-codebase-mcp --dev

メモ

現在、php-mcp/server（#23）と ReactPHP（#542）に依存関係の問題があります。laravel-codebase-mcp のインストール時に問題が発生した場合は、composer.json に以下を追加し、これらのパッチ適用済みフォークを一時的に使用する必要がある場合があります。

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/leantime/php-mcp-server.git"
    },
    {
      "type": "vcs",
      "url": "https://github.com/Leantime/reactphp-http.git"
    }
  ]
}

次に、AI エージェントの MCP 設定に追加します。

{
  "mcpServers": {
    "laravel-introspect": {
      "command": "php",
      "args": [
        "/path/to/your/codebase/artisan",
        "introspect:mcp"
      ]
    }
  }
}

重要

MCP サーバーはまだベータ版のため、バグが発生する可能性があります！

利用可能なクエリ

利用可能なクエリをすべて確認するには、laravel-introspect パッケージのドキュメントをご覧ください。

謝辞

この MCP サーバーは、MCP プロトコルの実装に php-mcp/server パッケージを使用しています。

ライセンス

MIT ライセンス（MIT）。詳細については、ライセンスファイルをご覧ください。