使用说明

项目简介

Bugsnag MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它允许像 Cursor 和 Claude 这样的 LLM 工具与 Bugsnag 错误监控平台进行交互。通过这个服务器，开发者可以使用自然语言命令，直接在 LLM 工具中浏览、分析和管理 Bugsnag 上的错误信息，从而提升问题排查和解决的效率。

主要功能点

错误监控与分析: 方便地浏览 Bugsnag 组织和项目层级结构，并使用强大的过滤器查找特定问题。
详细的堆栈追踪: 查看格式化的堆栈追踪信息，包含源代码上下文和高亮错误行。
异常链可视化: 理解错误的根本原因，查看完整的异常链。
代码智能: 区分项目代码和第三方库代码，查看错误位置周围的源代码片段，识别错误模式。
问题管理: 通过错误类别、消息或应用版本搜索问题，获取全面的错误详情和事件历史记录。

安装步骤

本项目无需手动下载源代码或安装，可以直接通过 'npx' 命令运行。

服务器配置

为了让 MCP 客户端（如 Cursor 或 Claude）连接到 Bugsnag MCP Server，您需要在客户端的 MCP 服务器配置中添加以下 JSON 配置。请将 'your-bugsnag-api-key' 替换为您在 Bugsnag 上生成的 API 密钥。

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

配置参数说明:

'server name': 'bugsnag' (服务器名称，可以自定义)
'command': 'npx' (用于执行 npm 包的命令)
'args': '["-y", "bugsnag-mcp-server"]' (传递给 'npx' 的参数，'-y' 表示自动确认安装 'bugsnag-mcp-server' 包，'bugsnag-mcp-server' 是要执行的包名)
'env': '{ "BUGSNAG_API_KEY": "your-bugsnag-api-key" }' (设置环境变量，'BUGSNAG_API_KEY' 用于存储您的 Bugsnag API 密钥，请务必替换为您的真实密钥)
'disabled': 'false' (设置为 'false' 表示启用该服务器)
'alwaysAllow': '[]' (允许所有工具，可以根据需要配置允许的工具列表)

如何获取 Bugsnag API Key:

登录您的 Bugsnag 账户 https://app.bugsnag.com/
进入 Settings > Organization settings > Access tokens
创建一个新的个人访问令牌，并赋予以下权限：
- Read projects
- Read and write errors
- Read and write comments
复制生成的令牌并替换配置中的 'your-bugsnag-api-key'。

基本使用方法

配置完成后，您可以在 LLM 工具中使用自然语言指令与 Bugsnag MCP Server 交互。以下是一些示例：

列出 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"'
搜索问题: 'Search for Bugsnag issues in project "project_12345" related to "NullPointerException"'

更多工具和使用示例请参考仓库 README 文档。

关键词