Laravel Artisan MCP Server

🚀 Laravel アーティザンartisan MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーであり、Claudeやその他のMCPクライアントを通じて、Laravelアーティザンコマンドを安全に実行することができます。このサーバーは、AIアシスタントとローカルのLaravelアプリケーションの間の架け橋として機能し、自然言語対話による制御された管理を可能にします。

✨ 主な機能

• Laravelプロジェクトを含む単一のディレクトリにアクセスする
• システム内のPHPを自動的に検出する
• ホワイトリストに登録されたアーティザンコマンドのみを実行する
• 利用可能なすべてのアーティザンコマンドを表示する
• 強力な入力検証を備えた安全な設計

📦 インストール

1. リポジトリをクローンする：

   git clone https://github.com/your-repository.git
   cd laravel-artisan-mcp-server
   

2. 仮想環境を設定する（推奨）：

   python3 -m venv venv
   source venv/bin/activate  # Windowsでは`venv\Scripts\activate`を使用
   

3. 依存関係をインストールする：

   composer install
   

📚 ドキュメント

設定

設定ファイルで以下の環境変数を設定します。

• ARTISAN_DIRECTORY：Laravelプロジェクトのディレクトリパスを指定します。
• PHP_EXECUTABLE（オプション）：PHPの実行ファイルのパスを指定します。

例えば、.envファイルで以下のように設定します。

ARTISAN_DIRECTORY=/path/to/laravel-project
PHP.Executable=/usr/bin/php8

テスト

MCP Inspectorを使用したテスト

1. MCP Inspectorをインストールして起動します。
2. Inspectorでターゲットサーバーを設定します。
3. 接続とコマンド実行を検証するためにコマンドを送信します。

Claudeとの統合

Claudeで使用するには以下の手順を行います。

1. MCPプロトコル定義をインポートします。
2. ClaudeプロキシをLaravelプロジェクトディレクトリに向けて設定します。
3. アーティザンコマンドを使用して対話します。

例えば、以下は簡単な呼び出しの例です。

claire run --protocol mcp-v1 \
    --config-path config.json \
    --directory /path/to/laravel-project \
    --command "php artisan migrate"

ツール

• claire：Claudeプロキシと通信するために使用します。
• mcp-inspector：MCPサーバーのテストとデバッグに使用します。

セキュリティに関する考慮事項

• ディレクトリ分離：指定されたLaravelディレクトリのみにアクセスします。
• コマンドホワイトリスト：許可されたコマンドのみを実行します。
• 入力検証：すべての入力は検証されます。
• エラー処理：機密情報の漏洩を防止します。

トラブルシューティング

"ARTISAN_DIRECTORY は設定で指定する必要があります"

• 環境変数が正しく設定されているか確認します。
• ディレクトリが存在し、アクセス可能か確認します。

"アーティザンが /path/to/artisan で見つかりません"

• 指定されたディレクトリにLaravelプロジェクトが含まれているか確認します。
• アーティザンファイルが存在し、実行権限があるか確認します。

"PHP実行ファイルが見つかりません"

• PHPがシステムにインストールされているか確認します。
• PHP実行ファイルがPATHに含まれているか確認します。

📄 ライセンス

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

作者

このMCPサーバーはClaude（AnthropicのAIアシスタント）の支援により作成されました。