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：

• “检查我的应用程序的运行状况”
• “显示日志中最后20个ERROR条目”
• “队列中失败的是什么？”
• “清除配置缓存”

可用工具

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

许可证

麻省理工学院