Stu Mason

Summary

Adds full MCP (Model Context Protocol) integration to Laravel Kick, enabling AI assistants like Claude to interact with your Laravel application through conversational tools.

What is MCP?

Model Context Protocol is an open standard for connecting AI assistants to external data sources and tools. This PR integrates with Laravel's official laravel/mcp package.

Changes

New MCP Server

KickServer auto-registers at /mcp/kick when both packages installed
Uses same token-based authentication as HTTP API
Configurable via KICK_MCP_ENABLED env var

8 MCP Tools

Tool	Description
`kick_health`	Check application health (DB, cache, storage, redis)
`kick_stats`	Get system/container statistics
`kick_logs_list`	List available log files
`kick_logs_read`	Read and filter log entries
`kick_queue_status`	Queue overview with optional failed jobs
`kick_queue_retry`	Retry a specific or all failed jobs
`kick_artisan_list`	List allowed artisan commands
`kick_artisan_run`	Execute whitelisted commands

Documentation

README updated with MCP setup instructions
Claude Desktop configuration example
Example conversation showing tool usage
CHANGELOG updated

Files Added

routes/mcp.php
src/Mcp/KickServer.php
src/Mcp/Tools/
  ├── ArtisanListTool.php
  ├── ArtisanRunTool.php
  ├── HealthTool.php
  ├── LogsListTool.php
  ├── LogsReadTool.php
  ├── QueueRetryTool.php
  ├── QueueStatusTool.php
  └── StatsTool.php

Test plan

All existing tests pass (94 tests, 277 assertions)
PHPStan passes
Pint passes
Manual test with Claude Desktop against local devtrends.test

Activity

PR #6 opened: feat: add MCP (Model Context Protocol) integration