Laravel Artisan MCP

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

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

✨ 主な機能

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

📦 インストール

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

   git clone https://github.com/diggy/laravel-artisan-mcp.git
   cd laravel-artisan-mcp
   

2. 仮想環境を作成し、依存関係をインストールします：

   python -m venv venv
   source venv/bin/activate  # Windows の場合は `venv\Scripts\activate` を使用
   pip install -r requirements.txt
   

3. サーバーを起動します：

   python server.py
   

📚 ドキュメント

設定

設定ファイル config.py を編集し、以下のパラメータを設定します。

• ARTISAN_DIRECTORY: Laravel プロジェクトのディレクトリを指定します。
• COMMAND_WHITELIST: 許可するコマンドをリストアップします。

使用例

# アーティサンコマンドを実行する
python server.py --command "php artisan migrate"

# ヘルプ情報を表示する
python server.py --help

サンプル画像

必要条件

• Python 3.10 以上
• アーティサン CLI を備えた Laravel プロジェクト
• インストールされ、PATH からアクセス可能な PHP
• MCP 互換のクライアント（例: Claude Desktop）

セキュリティ上の注意事項

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

トラブルシューティング

"ARTISAN_DIRECTORY は設定で提供されなければなりません"

サーバーが Laravel プロジェクトのパスを見つけることができません。以下を確認してください。

• 環境変数が正しく設定されていること
• ディレクトリが存在し、アクセス可能であること

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

指定されたディレクトリにアーティサン実行ファイルが含まれていません。以下を確認してください。

• パスが有効な Laravel プロジェクトディレクトリを指していること
• アーティサンファイルが存在し、実行権限があること

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

サーバーが PATH 内の PHP を見つけることができません。以下を確認してください。

• PHP がインストールされていること
• PHP 実行ファイルがシステムの PATH に含まれていること

免責事項

この Laravel アーティサン MCP サーバーは現状のまま提供され、いかなる形式の保証も付属していません。このソフトウェアを使用することで、その操作に関連するすべてのリスクを負うことに同意したことになります。このサーバーは開発またはテスト環境でコマンドを実行することができ、アプリケーションのデータや機能に影響を与える可能性があります。本ソフトウェアは正式なセキュリティ審査を受けておらず、実験的なものと見なされるべきです。自己責任で使用してください。

📄 ライセンス

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

作者

この MCP サーバーは、Claude（Anthropic の AI アシスタント）の支援を受けて開発されました。