Laravel Telescope MCP

Name: Laravel Telescope MCP
Author: lucianotonet

@lucianotonet

代码仓库

关于 Laravel Telescope MCP

暂无概览

#laravel #telescope #mcp #ai-assistant

基本信息

分类

其他

传输方式

stdio

发布者

lucianotonet

提交者

Luciano Tonet

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "Laravel Telescope MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8000/telescope-mcp",
        "--allow-http"
      ]
    }
  }
}

工具

Lists and analyzes batch operations

Monitors cache operations

Tracks Artisan command executions

Records var_dump and dd() calls

Monitors event dispatches

Tracks application errors

Records authorization checks

Tracks queued job executions

Records application logs

Monitors email operations

Tracks Eloquent model operations

Records notification dispatches

Monitors database queries

Tracks Redis operations

Records incoming HTTP requests

Monitors scheduled task executions

Records view renders

Removes old Telescope entries

概览

What is Laravel Telescope MCP?

Laravel Telescope MCP is an extension for Laravel Telescope that exposes telemetry data via the Model Context Protocol (MCP) to AI assistants such as Cursor, Claude, and Copilot Chat. Designed for developers using Telescope to inspect application metrics, it translates natural-language queries into MCP operations and returns precise insights.

How to use Laravel Telescope MCP?

Ensure Laravel Telescope is installed, then add the package via Composer (composer require lucianotonet/laravel-telescope-mcp) and optionally publish the configuration. Set TELESCOPE_MCP_ENABLED=true and a path (default telescope-mcp) in your .env. Connect an AI client by adding an MCP server configuration pointing to the HTTP endpoint, using npx mcp-remote as a bridge (e.g., http://localhost:8000/telescope-mcp). The AI can then query Telescope data using natural language.

Key features of Laravel Telescope MCP

Exposes 18 Telescope data types as MCP tools (batches, cache, commands, dumps, events, exceptions, gates, HTTP client, jobs, logs, mail, models, notifications, queries, Redis, requests, schedule, views)
Prune tool to remove old Telescope entries
Translates natural-language queries into MCP operations
Configurable endpoint path, middleware, timeouts, and logging
Works with HTTP or HTTPS transports
Supports authentication via Laravel middleware

Use cases of Laravel Telescope MCP

Quickly fetch the last 5 error logs using a simple AI prompt
Identify SQL queries longer than 100ms in the past twenty minutes
Show all last failed queue jobs
Summarize HTTP requests with status codes ≥500 since the last hour

FAQ from Laravel Telescope MCP

Do I need Laravel Telescope installed first?

Yes, Laravel Telescope must be properly installed and configured in your application before adding this package.

What runtime dependencies are required?

A Laravel application with PHP and Composer, plus Node.js/npx (for the MCP remote proxy used by clients like Cursor).

How does the MCP endpoint communicate?

Via HTTP (or HTTPS). The package exposes a manifest and tools at a configurable path (default telescope-mcp). AI clients connect using the mcp-remote transport.