星战科技xingzhan.cloud
返回市场
错误通知-mcp

错误通知-mcp

作者：tgeselle18 星标更新：2025-04-13
安装使用来源：spider==github.com

项目介绍

Bugsnag MCP Server

与Bugsnag交互的模型上下文协议（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. 登录到您的Bugsnag账户https://app.bugsnag.com/
  2. 前往设置 > 组织设置 > 访问令牌
  3. 创建一个新的个人访问令牌，具有以下权限：
    • 读取项目
    • 读写错误
    • 读写评论
  4. 复制生成的令牌以用于MCP服务器

📋 使用示例

配置完成后，您可以使用Bugsnag MCP服务器与您的大型语言模型工具一起工作。这里有一些示例提示：

探索您的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