AI导哈

错误监控协议服务器

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

  • by tgeselle
  • API Blueprint
  • 本地部署
  • 25 星标
  • 更新于
在 GitHub 查看 tgeselle/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": []
    }
  }
}

  2. 替换 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": []
    }
  }
}

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

🔑 获取Bugsnag API密钥

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

  1. 登录您的Bugsnag帐户 https://app.bugsnag.com/
  2. 首选 设置 > 组织设置 > 访问令牌
  3. 创建具有以下权限的新个人访问令牌：
    • 阅读项目
    • 读写错误
    • 阅读和撰写评论
  4. 复制生成的令牌以供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

  2. 安装依赖项：

    npm install

  3. 构建项目：

    npm run build

  4. 运行测试：

    npm test

  5. 运行覆盖率测试：

    npm run test:coverage

  6. 格式代码：

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 -用于检查代码格式

许可证

麻省理工学院

相关 MCP