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"
      }
    }
  }
}

然后向大模型询问：

• “检查我的应用运行状况”
• “显示日志中最近 20 条 ERROR 记录”
• “队列中有哪些任务失败了？”
• “清除配置缓存”

可用工具

工具	描述
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 命令白名单
• 路径遍历保护
• 自动清除日志中的个人身份信息

要求

• PHP 8.4+
• Laravel 12

许可证

MIT