Laravel优化工具

一款通过AI辅助优化Laravel项目的工具,提供配置分析、数据库监控、性能优化建议等功能。

  • by skylence-org
  • PHP
  • 本地部署
  • 更新于
在 GitHub 查看 skylence-be/laravel-optimize-mcp

使用说明

Laravel优化MCP

通过模型上下文协议(MCP)在人工智能的帮助下优化Laravel项目。

安装

通过Composer安装:

composer require skylence/laravel-optimize-mcp

运行安装命令并按照提示进行操作:

php artisan optimize-mcp:install

安装程序将:

  • 自动检测和配置您的代码编辑器(Cursor、Claude code、VS code或PhpStorm)
  • 询问是否需要临时/生产服务器的HTTP访问
  • 为远程访问生成安全令牌和配置说明

用法

安装后,让你的AI助手优化你的Laravel项目:

“分析我的Laravel项目并帮助我优化它”

您的AI将使用已安装的MCP工具:

  • 分析配置的性能和安全问题
  • 审查您的项目结构和开发工作流程
  • 推荐有用的软件包和改进
  • 用代码片段提供可操作的建议

暂存/生产的远程访问

想要分析您的登台或生产环境吗?安装程序可以自动为您配置,也可以通过将这些添加到您的 .env 文件:

# Enable secure HTTP access
OPTIMIZE_MCP_AUTH_ENABLED=true

# Generate token: php artisan tinker --execute="echo bin2hex(random_bytes(32))"
OPTIMIZE_MCP_API_TOKEN=your-secure-token-here

然后让你的AI连接到你的远程服务器:

“连接到我的Laravel服务器https://myapp.com并分析.env配置”

这允许您在没有SSH访问权限的情况下检查生产环境变量、缓存/会话驱动程序和安全设置。

数据库监控和警报

通过增长跟踪和电子邮件警报设置自动数据库大小监控:

启用监控

  1. 添加到您的 .env:
OPTIMIZE_MCP_DB_MONITORING=true
OPTIMIZE_MCP_DB_NOTIFICATION_EMAILS=dev@example.com,ops@example.com
OPTIMIZE_MCP_DB_WARNING_THRESHOLD=80
OPTIMIZE_MCP_DB_CRITICAL_THRESHOLD=90
  1. 运行迁移:
php artisan migrate
  1. 安排监控命令:

Laravel 11+/12 (in bootstrap/app.php):

->withSchedule(function (Schedule $schedule): void {
    $schedule->command('optimize-mcp:monitor-database')
        ->daily()
        ->onOneServer()
        ->when(fn () => config('app.schedule_enabled', true));
})

Laravel 10及更早版本 (in app/Console/Kernel.php):

protected function schedule(Schedule $schedule)
{
    // Run database monitoring daily (or hourly, weekly, etc.)
    $schedule->command('optimize-mcp:monitor-database')->daily();
}

使时间表可配置 (推荐):

添加到 config/app.php:

'schedule_enabled' => (bool) env('APP_SCHEDULE_ENABLED', true),

添加到 .env:

APP_SCHEDULE_ENABLED=true  # Set to false to disable all scheduled tasks

这允许您轻松启用/禁用每个环境(本地、暂存、生产)的计划。

可用命令

# Check database size manually
php artisan optimize-mcp:database-size

# Run monitoring (logs size, calculates growth, sends alerts)
php artisan optimize-mcp:monitor-database

# Clean up old logs (keeps 90 days by default)
php artisan optimize-mcp:prune-database-logs

特性

  • 自动跟踪:记录数据库大小、增长率和磁盘使用情况
  • 增长预测:根据增长趋势估计数据库何时会满
  • 智能警报:警告(80%)和严重(90%)阈值时的电子邮件通知
  • 历史数据:跟踪规模随时间的变化,以确定增长模式
  • 跨数据库:支持MySQL、PostgreSQL和SQLite

包含什么

  • 配置分析器:检查Laravel配置的性能和安全性
  • 数据库大小检查器:监视数据库大小、增长趋势和磁盘使用情况
  • 数据库监控和警报:通过电子邮件通知自动跟踪尺寸
  • 日志文件检查器:检查日志大小和轮换配置(仅限HTTP MCP)
  • Nginx配置检查器:分析nginx的安全性和性能(仅限HTTP MCP)
  • Nginx配置生成器:生成生产就绪的nginx配置(仅限HTTP MCP)
  • 项目结构分析器:审查您的作曲家脚本、CI/CD、测试设置等
  • 套餐顾问:为您的项目推荐有用的软件包

人工智能助理法学硕士指南

想让你的人工智能助手知道如何使用这些MCP工具吗?将Laravel Optimize MCP指南添加到项目的LLM指令文件中:

# From the root of your Laravel project
php vendor/skylence/laravel-optimize-mcp/bin/append-guidelines.php CLAUDE.md

# Or for other LLM instruction files
php vendor/skylence/laravel-optimize-mcp/bin/append-guidelines.php .cursorrules
php vendor/skylence/laravel-optimize-mcp/bin/append-guidelines.php .copilot-instructions.md

这附加了关于以下方面的全面指导方针:

  • 如何使用每个MCP工具
  • 何时使用HTTP MCP与stdio/PHP MCP工具
  • 安全和性能的最佳实践
  • 配置示例和常见解决方案

脚本将:

  • ✅ 在不覆盖的情况下将指南附加到现有文件
  • ✅ 如果指南已经存在,则跳过
  • ✅ 如果文件不存在,请使用指南创建文件

高级配置

有关远程访问、HTTP端点和自定义工具配置,请参阅 全部文件.

许可证

MIT许可证(MIT)。请看 许可证文件 了解更多信息。