Laravel MCP Companion

🚀 Laravel MCP Companion

Laravel MCP Companion は、Laravelエコシステム向けの包括的なドキュメント集約およびナビゲーションツールです。コンテンツを生成するのではなく、Laravelエコシステム全体の既存の高品質なドキュメントを集約・整理し、AIアシスタントを通じて簡単に検索できるようにします。

🚀 クイックスタート

⚠️ 重要提示

このプロジェクトは開発初期段階です。機能が期待通りに動作しない場合や、予告なく破壊的な変更が加えられる可能性があります。

✨ 主な機能

なぜLaravel MCP Companionが必要なのか？

Context7は一般的なドキュメント検索に優れていますが、Laravel MCP CompanionはLaravel開発者向けに設計されており、より高速でオフライン対応のLaravel固有の機能を備えています。

得られるもの:

• 複数バージョンのLaravelドキュメント (6.xから最新版) と強化された検索機能
• 自動検出機能付きLaravelサービス - Forge, Vapor, Envoyer, Nova
• コミュニティパッケージドキュメント - Spatie, Livewire, Inertia, Filament
• 精選されたパッケージ推薦 と詳細な統合ガイド
• 統一検索 - Laravelのコアドキュメント、サービス、パッケージ全体で検索可能
• スマートナビゲーション - ユースケースに合った正確な情報を見つけることができます
• 将来対応の更新 - Laravelサービスの変更に自動的に適応します

自動検出と更新頻度

このアプリケーションには、Laravelのドキュメントを自動的に見つけてインデックスするインテリジェントな自動検出システムが搭載されています。毎日、以下のことを行います。

• ✅ 自動検出 - Laravelサービス (Forge, Vapor, Nova, Envoyer) 全体の新しいドキュメントセクションを自動的に検出します。
• ✅ 取得 - 6.x以降のすべてのバージョンの最新のLaravelコアドキュメントを取得します。
• ✅ 取得 - コミュニティパッケージドキュメント (Spatie, Livewire, Inertia, Filament) を取得します。
• ✅ 適応 - ドキュメントウェブサイトの構造変更に自動的に適応します。
• ✅ 生成 - 更新が見つかった場合、自動的に新しいパッチリリースを生成します。

📦 インストール

Smitheryを使用したクイックインストール

npx -y @smithery/cli install @brianirish/laravel-mcp-companion --client claude

注: Smitheryは自動的にAIクライアントを設定します。

Claude Desktop

1. Claude Desktopの設定を開く
   • Claudeメニュー → 設定 → 開発者 → 設定の編集 をクリックします。
2. 設定ファイルに追加する:

   {
     "mcpServers": {
       "laravel-mcp-companion": {
         "command": "docker",
         "args": ["run", "--rm", "-i", "ghcr.io/brianirish/laravel-mcp-companion:latest"]
       }
     }
   }
   

3. Claude Desktopを再起動 して変更を反映させます。

設定ファイルの場所:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code

claude mcp add コマンドを使用します。

# Dockerで追加
claude mcp add laravel-mcp-companion docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest

# またはプロジェクト固有の設定に追加 (チーム共有用)
claude mcp add laravel-mcp-companion docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest --scope project

--scope project オプションを使用すると、プロジェクトルートに .mcp.json ファイルが作成され、バージョン管理にコミットできます。

設定オプション

これらのオプションはDockerコマンドとともに使用できます。例えば:

# Laravel 11.xのドキュメントのみを更新
docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest --version 11.x

# すべてのドキュメントを強制的に更新
docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest --force-update

# ForgeとVaporサービスのみを更新
docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest --services forge vapor

# LivewireとFilamentパッケージのみを更新
docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest --packages livewire filament

現在の機能とロードマップ

現在の機能

• ✅ 複数バージョンのLaravelドキュメント - 6.xから最新版までのすべてのバージョン
• ✅ 自動検出エンジン - Forge, Vapor, Nova, Envoyer全体の新しいドキュメントを見つけます。
• ✅ コミュニティパッケージドキュメント - Spatie, Livewire, Inertia, Filamentのドキュメント
• ✅ スマートパッケージ推薦 - 精選されたLaravelエコシステムのパッケージ
• ✅ 統一検索 - すべてのドキュメントソースを横断した1つの検索
• ✅ 毎日の更新 - 最新のドキュメントと自動的に同期します。
• ✅ 実績あり - 包括的なテストスイートにより信頼性が保証されます。

今後の機能

• 📚 v0.8.0: コミュニティ学習リソース (Laravel News, チュートリアル, ガイド)
• 🔍 v0.9.0: すべてのソースにわたる高度な検索とスマートナビゲーション
• 🚀 v1.0.0: 完全なLaravelドキュメントナビゲーター

詳細なロードマップ情報については、ROADMAP.md を参照してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

コントリビューション

コントリビューションは大歓迎です！ガイドラインについてはCONTRIBUTING.mdを参照してください。

謝辞

• 素晴らしいドキュメントを提供しているLaravel
• エコシステムに貢献しているLaravelパッケージの作者の皆様