Bugsnag MCP 服务器

一个用于与 Bugsnag 交互的模型上下文协议 (MCP) 服务器。该服务器允许像 Cursor 和 Claude 这样的 LLM 工具调查和解决 Bugsnag 中的问题。

✨ 功能

错误监控与分析

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

代码智能

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

问题管理

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

🚀 快速设置

设置 Bugsnag MCP 服务器非常简单，无需任何安装或下载源代码。

对于 Cursor

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

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

2. 将 your-bugsnag-api-key 替换为您的 Bugsnag API 密钥

对于 Claude Desktop

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

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

2. 将 your-bugsnag-api-key 替换为您的 Bugsnag API 密钥

🔑 获取 Bugsnag API 密钥

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

1. 登录到您的 Bugsnag 帐户：https://app.bugsnag.com/
2. 转到Settings（设置） > Organization settings（组织设置） > Access tokens（访问令牌）
3. 创建一个新的个人访问令牌，并具有以下权限：
   • Read projects（读取项目）
   • Read and write errors（读取和写入错误）
   • Read and write comments（读取和写入评论）
4. 复制生成的令牌以用于 MCP 服务器

📋 使用示例

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

浏览您的 Bugsnag 帐户

列出我所有的 Bugsnag 组织

显示组织 "org_12345" 中的所有项目

查找和分析错误

列出我的 Bugsnag 项目 "project_12345" 中的未解决错误

显示 Bugsnag 错误 ID "error_12345" 的详细信息

显示项目 "project_12345" 中事件 "event_12345" 的详细堆栈跟踪

查看项目 "project_12345" 中事件 "event_12345" 的异常链

搜索特定问题

搜索项目 "project_12345" 中与 "NullPointerException" 相关的 Bugsnag 问题

列出项目 "project_12345" 中错误 "error_12345" 的所有事件

📚 可用工具

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

组织和项目管理

list_organizations

列出可用的 Bugsnag 组织。

参数：

• 无需参数

list_projects

列出组织中的项目。

参数：

• organization_id (必需): Bugsnag 组织 ID

错误和事件管理

list_errors

列出项目中带有过滤选项的错误。

参数：

• project_id (必需): Bugsnag 项目 ID
• status: 按错误状态过滤 ("open", "fixed", "ignored")
• sort: 错误的排序顺序 ("newest", "oldest", "priority")
• limit: 要返回的最大错误数

view_error

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

参数：

• error_id (必需): Bugsnag 错误 ID

list_error_events

列出特定错误的事件（发生次数）。

参数：

• project_id (必需): Bugsnag 项目 ID
• error_id (必需): Bugsnag 错误 ID
• limit: 要返回的最大事件数

view_latest_event

查看错误的最新事件。

参数：

• error_id (必需): Bugsnag 错误 ID

view_event

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

参数：

• project_id (必需): Bugsnag 项目 ID
• event_id (必需): Bugsnag 事件 ID

堆栈跟踪分析

view_stacktrace

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

参数：

• project_id (必需): Bugsnag 项目 ID
• event_id (必需): Bugsnag 事件 ID
• include_code: 如果可用，则包含源代码上下文（默认值：true）

view_exception_chain

查看事件的完整异常链。

参数：

• project_id (必需): Bugsnag 项目 ID
• event_id (必需): Bugsnag 事件 ID

问题管理

search_issues

使用各种条件搜索问题。

参数：

• project_id (必需): Bugsnag 项目 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
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 运行测试：

   npm test
   

5. 运行带有覆盖率的测试：

   npm run test:coverage
   

6. 格式化代码：

npm run format

7. 检查代码格式：

npm run format:check

持续集成

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

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

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

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

许可证

MIT