Bugsnag MCP Server

Bugsnag MCP 服务

一个用于与 Bugsnag 交互的 Model Context Protocol (MCP) 服务。该服务允许 Cursor 和 Claude 等大模型工具调查并解决 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. 在 https://app.bugsnag.com/ 登录你的 Bugsnag 账户
2. 前往 Settings > Organization settings > Access tokens
3. 创建一个具有以下权限的新个人访问令牌：
   • Read projects
   • Read and write errors
   • Read and write comments
4. 复制生成的令牌，用于 MCP 服务

📋 使用示例

配置完成后，你可以在大模型工具中使用 Bugsnag MCP 服务。以下是一些示例提示词：

探索你的 Bugsnag 账户

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 服务提供以下工具：

组织与项目管理

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 进行持续集成。工作流会自动：

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

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

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

许可证

MIT