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驱动的应用程序带来企业级监控功能。
📄 许可证
文档未提及许可证信息,故此处省略。
微信扫一扫