lucianotonet/laravel-telescope-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

23 stars 5 forks 质量 82 趋势 18MIT

Repository Install

拉拉维尔望远镜的MCP服务器

概览

Laravel 望远镜的一个扩展，通过模型上下文协议（MCP）向 AI 助手（如 Cursor、Claude、Copilot Chat）展示遥测数据。非常适合使用望远镜检查应用指标并需要快速、精准洞察的开发者。 Telescope MCP 通过模型上下文协议（MCP）公开所有 Laravel 望远镜遥测数据，使 AI 助手能够直接访问和分析应用指标。这为开发者提供了关于日志、慢查询、HTTP 请求、异常、作业等的实时洞察，通过自然语言查询。 - PHP 8.3+ - Laravel 11、12 或 13 - Laravel 望远镜 5.0+ HTTP MCP 端点是。如果你在线暴露它，请先启用认证（参见“IDE 中的安全流式 HTTP”）。

概述（AI 翻译）

Laravel 望远镜的一个扩展，通过模型上下文协议（MCP）向 AI 助手（如 Cursor、Claude、Copilot Chat）展示遥测数据。非常适合使用望远镜检查应用指标并需要快速、精准洞察的开发者。

概述

Telescope MCP 通过模型上下文协议（MCP）公开所有 Laravel 望远镜遥测数据，使 AI 助手能够直接访问和分析应用指标。这为开发者提供了关于日志、慢查询、HTTP 请求、异常、作业等的实时洞察，通过自然语言查询。

要求

PHP 8.3+
拉拉维尔 11、12 或 13
拉拉维尔望远镜 5.0+

[!重要] HTTP MCP 端点默认未被认证。如果你在线暴露它，请先启用认证（参见“IDE 中的安全可流式 HTTP”）。

状态：✅19个MCP工具完全可运行且集成

v1.0 新增内容

🎉 现在由官方Laravel/MCP软件包驱动！

基于Laravel官方MCP框架构建，提升可维护性和长期支持
改进架构，使用[[T0]实现更清晰的工具定义。

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

An extension for Laravel Telescope that exposes telemetry data via the Model Context Protocol (MCP) to AI assistants (e.g., Cursor, Claude, Copilot Chat). Ideal for developers who use Telescope to inspect application metrics and require quick, precise insights.

Overview

Telescope MCP exposes all Laravel Telescope telemetry data via the Model Context Protocol (MCP), enabling AI assistants to directly access and analyze application metrics. This provides developers with instant insights into logs, slow queries, HTTP requests, exceptions, jobs, and more through natural language queries.

Requirements

PHP 8.3+
Laravel 11, 12 or 13
Laravel Telescope 5.0+

[!IMPORTANT] The HTTP MCP endpoint is not authenticated by default. If you expose it online, enable authentication first (see “Secure Streamable HTTP in IDEs”).

Status: ✅ 19 MCP tools fully operational and integrated

What’s New in v1.0

🎉 Now powered by the official Laravel/MCP package!

Built on Laravel’s official MCP framework for better maintainability and long-term support
Improved architecture with cleaner tool definitions using Laravel\Mcp\Server\Tool
Enhanced schema validation with JsonSchema builder
Better request handling with Laravel\Mcp\Request and Laravel\Mcp\Response
Full backward compatibility maintained - all 19 tools work identically
Ready for future Laravel/MCP features (Resources, Prompts, OAuth authentication)

Quick Start

Install the package:

composer require lucianotonet/laravel-telescope-mcp --dev

Auto-configure your MCP client:
```
php artisan telescope-mcp:install
```
💡 Automatically detects and configures: Cursor, Claude Code, Windsurf, Cline, Gemini App, Antigravity, Codex, and OpenCode.
Restart your IDE/editor and start using tools!

Detailed Installation

1. Require Package

composer require lucianotonet/laravel-telescope-mcp --dev

2. Configure MCP Client

You can use the automatic installer or configure manually.

在 GitHub 查看完整 README

安装

npx -y @modelcontextprotocol/inspector --transport http --server-url "https://your-domain.com/telescope-mcp"

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "laravel-telescope": {
      "command": "php",
      "args": ["artisan", "telescope-mcp:server"],
      "cwd": "/path/to/your/project",
      "env": {
        "APP_ENV": "local"
      }
    }
  }
}