AI导哈

Laravel Telescope MCP服务器

一个为Laravel Telescope提供实时监控、性能分析和调试功能的MCP服务器。

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

使用说明

Laravel望远镜MCP

Laravel Telescope的强大MCP（模型上下文协议）服务器，通过Claude Code和其他MCP客户端提供实时监控、性能分析和调试。

特性

  • STDIO和HTTP支持 -与Claude Code（stdio）或任何HTTP客户端一起使用
  • 路由类型筛选 -API与Web路由（包括Filament面板）的单独分析
  • 性能监控 -请求次数、查询分析、N+1检测
  • 健康评分 -每种路线类型具有不同阈值的上下文感知健康评分
  • 异常跟踪 -监控和分析应用程序错误
  • 队列监视 -跟踪作业执行和失败情况
  • 缓存分析 -命中率和操作跟踪

安装

composer require skylence/laravel-telescope-mcp

发布配置（可选）：

php artisan vendor:publish --tag=telescope-mcp-config

配置

克劳德码（stdio模式）

添加到您的 .mcp.json:

{
  "mcpServers": {
    "telescope": {
      "type": "stdio",
      "command": "php",
      "args": ["artisan", "mcp:start", "telescope"]
    }
  }
}

环境变量

TELESCOPE_MCP_ENABLED=true
TELESCOPE_MCP_AUTH_ENABLED=false
TELESCOPE_MCP_SLOW_REQUEST_MS=1000
TELESCOPE_MCP_SLOW_QUERY_MS=100

路由类型筛选

路由由中间件自动分类以进行单独分析：

// config/telescope-mcp.php
'overview' => [
    'route_groups' => [
        'api' => [
            'middleware' => ['api'],
        ],
        'web' => [
            'middleware' => ['web', 'panel:*'], // Includes Filament panels
        ],
    ],
    'thresholds' => [
        'api' => [
            'slow_request_ms' => 500,      // APIs should be fast
            'acceptable_error_rate' => 0.01,
        ],
        'web' => [
            'slow_request_ms' => 1500,     // Web pages can be slower
            'acceptable_error_rate' => 0.05,
        ],
    ],
],

这 panel:* 通配符与Filament面板中间件匹配（例如。， panel:app, panel:admin).

可用工具

望远镜概述

系统健康状况概述，包括性能指标和路由细分。

telescope_overview(period="1h", route_type="all", include_breakdown=true)

请求：

HTTP请求分析，按路由类型过滤。

requests(action="stats", route_type="api", period="1h")
requests(action="slow", route_type="web", min_duration=1000)

查询

数据库查询分析和N+1检测。

queries(action="stats", period="1h")
queries(action="slow", min_time=100)
queries(action="duplicates")

例外

异常和错误跟踪。

exceptions(action="list", period="24h")
exceptions(action="stats")

工作

队列作业监控。

jobs(action="stats", period="1h")
jobs(action="failed")

缓存

缓存操作分析。

cache(action="stats", period="1h")

日志

应用程序日志条目。

logs(action="list", level="error", period="1h")

快速示例

健康检查：

telescope_overview(period="1h", route_type="all")

API特定监控：

telescope_overview(period="1h", route_type="api")
requests(action="stats", route_type="api")

查找慢速端点：

requests(action="slow", route_type="api", min_duration=500)

检测N+1个查询：

queries(action="duplicates", period="1h")

健康评分

健康评分（0-100）是使用上下文感知阈值计算的：

分数 状态 描述
90-100 健康 一切最佳
70-89 良好 小问题
50-69 警告 需要注意
0-49 危急 需要立即采取行动

API和web路由使用不同的阈值-对API的判断更加严格。

需求

  • PHP 8.1+
  • Laravel 10、11或12
  • Laravel望远镜

许可证

麻省理工学院

相关 MCP