AI导哈

Laravel应用内省服务

Laravel Kick 是一个用于Laravel应用内省的MCP服务器和REST API，允许通过自然语言对话检查应用健康状态、读取日志、检查队列和执行命令。

  • by StuMason
  • PHP
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 StuMason/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条目”
  • “队列中失败的是什么？”
  • “清除配置缓存”

可用工具

工具 说明
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

许可证

麻省理工学院

相关 MCP