Laravel Artisan MCP

MCPプロトコルに基づくLaravel Artisanコマンド実行サーバーで、AIアシスタントを通じてローカルのLaravelプロジェクトを安全に管理します

開発者ツール人工知能チャットボット #Laravel管理 #コマンド実行 #AI統合 #ローカル開発 .Python

スコア : 2.5ポイント

ダウンロード数 : 6.4K

更新時間 : 2025-04-28

サイトを開く

Laravel Artisan MCPサーバーとは？

Laravel Artisan MCPサーバーは、自然言語対話を通じてLaravelアプリケーション内のArtisanコマンドを管理および実行できる安全なサーバーです。これは、AIアシスタントとローカルのLaravelプロジェクトをつなぐ強力な架け橋となります。

Laravel Artisan MCPサーバーの使い方は？

数ステップで使用を開始できます。まずサーバーをインストールし、次に環境変数を設定し、最後にAIアシスタント（Claudeなど）に統合して使用します。

適用シナリオ

開発者、運用担当者、およびLaravelプロジェクトを迅速に管理する必要のあるチームに適しています。

主要機能

単一ディレクトリアクセス

指定されたLaravelプロジェクトディレクトリに限定され、安全性を確保します。

PHP自動検出

システム上のPHPパスを自動的に見つけるため、手動での設定は不要です。

コマンドホワイトリスト

事前に承認されたArtisanコマンドのみを実行し、誤操作を防止します。

全面的な入力検証

すべての入力を厳密に検証し、潜在的なセキュリティリスクを回避します。

エラー処理

機密情報の漏洩を防止し、安定性を向上させます。

利点

自然言語でLaravelプロジェクトを簡単に管理できます。

コマンドホワイトリストをサポートし、誤操作を減らします。

PHPパスを自動検出するため、インストールプロセスが簡素化されます。

詳細なエラーフィードバックとログ記録を提供します。

複数のAIアシスタントの統合をサポートし、高い柔軟性を持ちます。

制限

ローカル環境にインストールおよび設定する必要があります。

追加の権限設定が必要になる場合があります。

本番環境で使用する場合は、ホワイトリストを慎重に設定する必要があります。

PHPとPythonの正しいインストールに依存しています。

使い方

コードリポジトリをクローンする

Gitを使用してこのプロジェクトをローカルにクローンします。

仮想環境を初期化する

仮想環境を作成してアクティブ化します。

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

必要なPython依存関係をインストールします。

環境変数を設定する

ARTISAN_DIRECTORYとWHITELISTED_COMMANDS変数を設定します。

サーバーを起動する

サーバーを実行してMCPリクエストを待機します。

使用例

ケース1: すべてのルートを表示する

自然言語ですべての利用可能なルートを照会します。

ケース2: キャッシュをクリアする

キャッシュをクリアしてパフォーマンスを向上させます。

ケース3: コントローラーを作成する

AIアシスタントを通じて新しいコントローラーを作成します。

よくある質問

ARTISAN_DIRECTORYが指定されていない場合、どうなりますか？

Artisanコマンドが見つからないのはなぜですか？

PHPが見つからない場合はどうすればいいですか？

安全性を確保するにはどうすればいいですか？

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

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

✨ 主な機能

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

📦 インストール

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

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

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

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

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