JinDaGe - mcp-server MCP Details

article

README

🚀 Inspector MCP Server

Inspector MCP Server专为PHP生态系统构建；该服务器提供工具，允许AI编码代理访问具有全面上下文的生产错误数据，自动修复问题，并为根本原因分析和解决策略提供可行的建议。

🚀 快速开始

✨ 主要特性

🔍 智能错误分析 - AI代理可以获取并分析近期生产错误，并具备全面的上下文信息。
📊 智能优先级排序 - 根据错误频率、严重程度和新近度自动对错误进行分类。
💡 可行的建议 - 由AI提供的根本原因分析和解决策略建议。
🎯 代码级洞察 - 与堆栈跟踪和应用程序源代码位置直接集成。
⚡ 开发者体验 - 针对现代PHP开发工作流程进行了优化，包括Neuron AI框架。

📦 安装指南

标准输入输出传输（在本地机器上安装）

安装

你可以在项目中将MCP服务器作为开发依赖项进行安装：

composer require inspector-apm/mcp-server --dev

客户端配置

以下配置适用于MCP客户端，如编码代理（Claude Code、Gemini Code Assist等）或智能IDE（如Jetbrains、Windsurf、Cursor等）。

{
    "mcpServers": {
        "inspector": {
            "command": "php",
            "args": [
                "absolute-path-to-your-app-vendor-folder/inspector-apm/mcp-server/server.php"
            ],
            "env": {
                "INSPECTOR_API_KEY": "xxxx", // Inspector API密钥 (https://app.inspector.dev/account/api)
                "INSPECTOR_APP_ID": "xxxx" // Inspector仪表板上的应用程序ID
            }
        }
    }
}

你需要以下三项信息来完成此配置：

vendor文件夹的绝对路径：这是你项目的vendor文件夹在计算机中的根路径。接下来的部分是指向运行MCP服务器的文件的路径（inspector-apm/mcp-server/server.php）。
INSPECTOR_API_KEY：点击此处生成新的API密钥。
INSPECTOR_APP_ID：这是你在Inspector中的应用程序的唯一标识符。你可以在Inspector仪表板的“应用程序设置”菜单中获取此信息。

你可以通过导航到Inspector仪表板中的“应用程序设置”部分来获取应用程序的MCP配置。

Claude Code配置

一旦你获得了上述信息，就可以使用以下命令将Inspector MCP服务器连接到Claude Code：

claude mcp add inspector --env INSPECTOR_API_KEY=YOUR_KEY --env INSPECTOR_APP_ID=YOUR_APP_ID -- php absolute_path_to_your_app_vendor_folder/inspector-apm/mcp-server/server.php

对于其他代理，请查阅其文档以了解如何连接到本地（标准输入输出）MCP服务器。

💻 使用示例

基础用法

以下是安装MCP服务器的命令：

composer require inspector-apm/mcp-server --dev

高级用法

以下是MCP客户端的配置示例：

{
    "mcpServers": {
        "inspector": {
            "command": "php",
            "args": [
                "absolute-path-to-your-app-vendor-folder/inspector-apm/mcp-server/server.php"
            ],
            "env": {
                "INSPECTOR_API_KEY": "xxxx", // Inspector API密钥 (https://app.inspector.dev/account/api)
                "INSPECTOR_APP_ID": "xxxx" // Inspector仪表板上的应用程序ID
            }
        }
    }
}

📚 详细文档

可用工具

| 属性 | 详情 | |------|------| | 名称 | 描述 | | get_production_errors | 获取近期生产错误，以调试和修复应用程序问题。返回错误的综合分析，包括频率、严重程度、受影响的代码位置以及AI驱动的解决建议。在调查应用程序问题、性能问题或需要了解生产环境中当前存在的问题时使用此工具。对于主动调试和维护应用程序可靠性至关重要。 | | get_error_analysis | 获取生产环境中的详细错误分析，包括实际的应用程序源文件（不仅仅是库堆栈跟踪）、错误模式、代码上下文、发生频率以及结构化的调试指导，以帮助你快速解决问题。 | | worst_performing_transactions | 检索所选时间范围（默认24小时）内表现最差的十个事务列表。事务表示应用程序的执行周期。它可以是HTTP请求、后台作业或控制台命令。 | | transaction_details | 检索事务详细信息以及事务期间执行的所有任务的时间线。时间线包括每个任务（数据库查询、缓存命令、对外部HTTP服务的调用等）的开始时间和持续时间。 | | 属性 | 详情 | | (int) $hours | 时间范围（小时） | | (int) $limit | 限制数量 | | (string) $group_hash | 错误组哈希 |

它的作用

将你的AI编码助手转变为具有生产感知能力的调试伙伴：

🔍 智能错误分析 - AI代理可以获取并分析近期生产错误，并具备全面的上下文信息。
📊 智能优先级排序 - 根据错误频率、严重程度和新近度自动对错误进行分类。
💡 可行的建议 - 由AI提供的根本原因分析和解决策略建议。
🎯 代码级洞察 - 与堆栈跟踪和应用程序源代码位置直接集成。
⚡ 开发者体验 - 针对现代PHP开发工作流程进行了优化，包括Neuron AI框架。

关键特性

生产错误监控

检索过去24小时内的错误，并带有详细的上下文信息。
频率分析和趋势检测。
实时错误状态和新近度指示。

AI优化报告

对大语言模型（LLM）友好的错误格式，以实现最大程度的理解。
检测重复问题的模式。
自动对错误类型进行分类（API问题、数据库问题、性能瓶颈）。

以开发者为中心的设计

与框架无关的PHP集成。
全面的堆栈跟踪分析。
直接引用代码位置，以便更快地进行调试。

适用场景

PHP开发者：构建现代应用程序并希望获得AI辅助调试的开发者。
使用Inspector.dev进行生产监控的团队。
Neuron AI框架用户：在开发工作流程中利用AI代理的用户。
DevOps工程师：寻求智能错误分析和解决指导的工程师。

🔧 技术细节

该MCP服务器由Inspector.dev和Neuron AI框架背后的团队开发，为AI驱动的应用程序带来企业级监控功能。

📄 许可证

文档未提及许可证信息，故此处省略。

mcp-server