Bugsnag MCP

MCP服务器故障

用于与Bugsnag交互的模型上下文协议（MCP）服务器。此服务器允许Cursor和Claude等LLM工具调查和解决Bugsnag中的问题。

✨ 特性

错误监控与分析

• 组织与项目导航：轻松浏览您的Bug层次结构
• 错误和事件筛选：使用强大的过滤选项查找特定问题
• 详细的堆栈跟踪查看：查看带有源代码上下文和突出显示的错误行的格式化堆栈跟踪
• 异常链可视化：通过查看完整的异常链了解根本原因

代码智能

• 项目与库代码的区别：明确标识您的代码与第三方库
• 源代码上下文：查看错误位置周围的相关代码片段
• 错误模式：识别多个错误中重复出现的模式

问题管理

• 搜索功能：按错误类别、消息或应用程序版本查找问题
• 错误详细信息：获取有关每个错误的全面信息
• 事件历史：查看特定错误的所有出现情况

🚀 快速设置

设置Bugsnag MCP服务器很简单，不需要任何安装或下载源代码。

对于光标

1. 添加Bugsnag MCP服务器配置：

   {
     "mcpServers": {
       "bugsnag": {
         "command": "npx",
         "args": ["-y", "bugsnag-mcp-server"],
         "env": {
           "BUGSNAG_API_KEY": "your-bugsnag-api-key"
         },
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }

1. 替换 your-bugsnag-api-key 使用Bugsnag API密钥

适用于克劳德桌面

1. 添加Bugsnag MCP服务器配置：

   {
     "mcpServers": {
       "bugsnag": {
         "command": "npx",
         "args": ["-y", "bugsnag-mcp-server"],
         "env": {
           "BUGSNAG_API_KEY": "your-bugsnag-api-key"
         },
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }

1. 替换 your-bugsnag-api-key 使用Bugsnag API密钥

🔑 获取Bugsnag API密钥

要使用此MCP服务器，您需要一个Bugsnag API密钥：

1. 登录您的Bugsnag帐户 https://app.bugsnag.com/
2. 首选 设置 > 组织设置 > 访问令牌
3. 创建具有以下权限的新个人访问令牌：

- 阅读项目 - 读写错误 - 阅读和撰写评论

1. 复制生成的令牌以供MCP服务器使用

📋 使用示例

配置后，您可以将Bugsnag MCP服务器与LLM工具一起使用。以下是一些示例提示：

探索您的Bug帐户

List all my Bugsnag organizations

Show me all projects in organization "org_12345"

查找和分析错误

List the open errors in my Bugsnag project "project_12345"

Show me the details for Bugsnag error ID "error_12345"

Show me the detailed stacktrace for event "event_12345" in project "project_12345"

View the exception chain for event "event_12345" in project "project_12345"

寻找具体问题

Search for Bugsnag issues in project "project_12345" related to "NullPointerException"

List all events for error "error_12345" in project "project_12345"

📚 可用工具

Bugsnag MCP服务器提供以下工具：

组织与项目管理

列表_组织

列出可用的Bugsnag组织。

参数：

• 无需

list_项目

列出组织中的项目。

参数：

• organization_id （必填）：Bug组织ID

错误和事件管理

list_错误

使用筛选选项列出项目中的错误。

参数：

• project_id （必填）：Bug项目ID
• status：按错误状态筛选（“打开”、“已修复”、“忽略”）
• sort：错误的排序顺序（“最新”、“最旧”、“优先级”）
• limit：要返回的最大错误数

view_错误

获取有关特定错误的详细信息。

参数：

• error_id （必填）：Bug错误ID

list_error_events

列出特定错误的事件（事件）。

参数：

• project_id （必填）：Bug项目ID
• error_id （必填）：Bug错误ID
• limit：要返回的最大事件数

view_latest_event

查看错误的最新事件。

参数：

• error_id （必填）：Bug错误ID

view_事件

查看特定事件的详细信息。

参数：

• project_id （必填）：Bug项目ID
• event_id （必填）：Bug事件ID

堆栈跟踪分析

view_stacktrace

从事件中提取并格式化堆栈跟踪信息。

参数：

• project_id （必填）：Bug项目ID
• event_id （必填）：Bug事件ID
• include_code：包括源代码上下文（如果可用）（默认值：true）

view_exception_chain

查看事件的完整异常链。

参数：

• project_id （必填）：Bug项目ID
• event_id （必填）：Bug事件ID

问题管理

搜索问题

使用各种条件搜索问题。

参数：

• project_id （必填）：Bug项目ID
• query：搜索查询
• error_class：按错误类别筛选
• app_version：按应用程序版本筛选

🛠️ 高级用法

测试您的API密钥

您可以使用以下方法测试Bugsnag API密钥是否有效：

npx bugsnag-mcp-server test-api-key your-bugsnag-api-key

如果你的API密钥是有效的，这将显示你的Bugsnag项目及其ID的列表。

安装选项

使用时 npx 建议大多数用户使用，如果您愿意，也可以全局安装该软件包：

npm install -g bugsnag-mcp-server

面向开发者

如果你有兴趣贡献或修改代码：

1. 克隆存储库：

   git clone https://github.com/yourusername/bugsnag-mcp.git
   cd bugsnag-mcp

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

1. 运行测试：

   npm test

1. 运行覆盖率测试：

   npm run test:coverage

1. 格式代码：

npm run format

1. 检查代码格式：

npm run format:check

持续集成

该项目使用GitHub Actions进行持续集成。工作流会自动执行以下操作：

• 在向主分支推送和拉取请求时运行
• 针对多个Node.js版本（18.x和20.x）的测试
• 运行测试套件
• 生成并上传测试覆盖率报告
• 使用Prettier检查代码格式

您可以在以下位置查看工作流配置：

• .github/workflows/test.yml -用于运行测试
• .github/workflows/prettier.yml -用于检查代码格式

许可证

麻省理工学院