Bugsnag MCP Server
Overview
✨ 核心功能
错误监控与分析
- 组织与项目导航：轻松浏览 Bugsnag 的层级结构
- 错误与事件过滤：通过强大的过滤选项查找特定问题
- 详细堆栈跟踪查看：查看格式化的堆栈跟踪，包含源代码上下文和高亮错误行
- 异常链可视化：通过查看完整的异常链理解根本原因
代码智能
- 项目与库代码区分：清晰识别自有代码与第三方库代码
- 源代码上下文：查看错误位置周围的相关代码片段
- 错误模式识别：识别多个错误中的重复模式
问题管理
- 搜索能力：通过错误类、消息或应用版本查找问题
- 错误详情：获取每个错误的全面信息
- 事件历史：查看特定错误的所有发生记录
🚀 适用场景
- 开发团队需要快速定位和解决应用程序中的错误
- 需要分析错误模式和趋势以提高代码质量
- 需要与团队成员协作处理复杂错误
- 需要集成错误监控到开发工作流中
📚 可用工具
组织与项目管理
list_organizations：列出可用的 Bugsnag 组织list_projects：列出组织中的项目
错误与事件管理
list_errors：列出项目中的错误（带过滤选项）view_error：获取特定错误的详细信息list_error_events：列出特定错误的事件view_latest_event：查看错误的最新事件view_event：查看特定事件的详细信息
堆栈跟踪分析
view_stacktrace：从事件中提取并格式化堆栈跟踪信息view_exception_chain：查看事件的完整异常链
问题管理
search_issues：使用各种条件搜索问题
🛠️ 使用教程
前置依赖
- 确保已安装 Node.js（推荐 18.x 或 20.x 版本）
- 确保已安装 npm 或 yarn
安装步骤
对于 Cursor 用户
-
添加 Bugsnag MCP 服务器配置：
json { "mcpServers": { "bugsnag": { "command": "npx", "args": ["-y", "bugsnag-mcp-server"], "env": { "BUGSNAG_API_KEY": "your-bugsnag-api-key" }, "disabled": false, "alwaysAllow": [] } } } -
将
your-bugsnag-api-key替换为你的 Bugsnag API 密钥
对于 Claude Desktop 用户
-
添加 Bugsnag MCP 服务器配置：
json { "mcpServers": { "bugsnag": { "command": "npx", "args": ["-y", "bugsnag-mcp-server"], "env": { "BUGSNAG_API_KEY": "your-bugsnag-api-key" }, "disabled": false, "alwaysAllow": [] } } } -
将
your-bugsnag-api-key替换为你的 Bugsnag API 密钥
获取 Bugsnag API 密钥
- 登录你的 Bugsnag 账户 https://app.bugsnag.com/
- 转到 设置 > 组织设置 > 访问令牌
- 创建一个新的个人访问令牌，具有以下权限：
- 读取项目
- 读取和写入错误
- 读取和写入评论
- 复制生成的令牌用于 MCP 服务器
调试方式
测试你的 API 密钥是否有效：
npx bugsnag-mcp-server test-api-key your-bugsnag-api-key
如果 API 密钥有效，这将显示你的 Bugsnag 项目列表及其 ID。
❓ 常见问题
-
如何安装全局版本？
bash npm install -g bugsnag-mcp-server -
如何为开发做贡献？
- 克隆仓库：
git clone https://github.com/yourusername/bugsnag-mcp.git - 安装依赖：
npm install - 构建项目：
npm run build - 运行测试：
npm test -
检查代码格式：
npm run format:check -
如何查看测试覆盖率？
bash npm run test:coverage