Laravel Kick

Laravel Kick

Laravel アプリケーションを調査するための MCP サーバーと REST API です。

MCP クライアントを Laravel アプリに直接接続できます。ヘルス状態の確認、ログの読み取り、キューの調査、コマンドの実行を、すべて自然な会話を通じて行えます。

ドキュメント

インストール

composer require stumason/laravel-kick

.env に追加します。

KICK_ENABLED=true
KICK_TOKEN=your-secure-random-token

MCP のセットアップ

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "my-app": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://your-app.com/mcp/kick",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer your-kick-token"
      }
    }
  }
}

次に、LLM に以下のように尋ねます。

• 「アプリのヘルス状態を確認して」
• 「ログの最後の ERROR エントリーを 20 件表示して」
• 「キューで何が失敗している？」
• 「設定キャッシュをクリアして」

利用可能なツール

ツール	説明
kick_health	データベース、キャッシュ、ストレージ、redis の接続状態
kick_stats	CPU、メモリ、ディスク、稼働時間
kick_logs_list	ログファイルの一覧表示
kick_logs_read	フィルタリングしてログを読み取り
kick_queue_status	キューの概要、失敗したジョブ
kick_queue_retry	失敗したジョブを再試行
kick_artisan_list	利用可能なコマンドの一覧表示
kick_artisan_run	許可リストに登録されたコマンドを実行

REST API

同じ機能を HTTP 経由で利用できます。

curl -H "Authorization: Bearer $TOKEN" https://app.com/kick/health
curl -H "Authorization: Bearer $TOKEN" https://app.com/kick/stats
curl -H "Authorization: Bearer $TOKEN" "https://app.com/kick/logs/laravel.log?level=ERROR"
curl -X POST -H "Authorization: Bearer $TOKEN" -d '{"command":"cache:clear"}' https://app.com/kick/artisan

すべてのエンドポイントについては、API ドキュメントをご覧ください。

セキュリティ

• デフォルトでは無効です（KICK_ENABLED=false）
• スコープを備えたトークンベースの認証
• Artisan コマンドの許可リスト
• パストラバーサル対策
• ログから個人を特定できる情報（PII）を自動的に除去

必要条件

• PHP 8.4+
• Laravel 12

ライセンス

MIT