使用说明

项目简介

Rollbar MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 LLM 应用和 Rollbar 错误追踪服务之间的桥梁。通过 Rollbar MCP Server，LLM 可以访问 Rollbar 平台上的错误数据、项目信息、部署状态和用户信息，从而实现更智能的错误分析、问题诊断和自动化运维流程。

主要功能点

错误信息查询与过滤: LLM 可以通过工具查询 Rollbar 中记录的错误信息，支持按状态、等级、环境等条件进行过滤，快速定位关键错误。
错误详情查看: 获取特定错误的详细信息，包括堆栈追踪、发生次数等，帮助 LLM 理解错误的上下文和根本原因。
项目和环境信息访问: LLM 可以获取 Rollbar 项目列表、项目详情以及项目相关的环境信息，了解应用部署和错误分布情况。
部署追踪: 查询和查看 Rollbar 中记录的部署信息，帮助 LLM 理解代码变更与错误发生之间的关联。
用户和团队信息: 访问 Rollbar 用户和团队信息，为基于用户或团队的错误分析和通知提供数据基础。

安装步骤

克隆仓库 如果需要本地部署，首先克隆该 GitHub 仓库到本地：

git clone https://github.com/hiyorineko/mcp-rollbar-server
cd mcp-rollbar-server

安装依赖 在仓库根目录下，运行以下命令安装项目依赖：
```
npm install
```
构建项目 运行构建命令，将 TypeScript 代码编译为 JavaScript：
```
npm run build
```

服务器配置

MCP 客户端（如 Cursor 编辑器）需要配置 MCP 服务器的启动命令才能连接 Rollbar MCP Server。在 Cursor 编辑器的 '~/.cursor/mcp.json' 文件中，添加以下配置：

使用 npm 全局安装 (推荐):

{
    "mcpServers": {
      "rollbar-mcp": {
        "command": "npx",
        "args": ["-y", "@hiyorineko/mcp-rollbar-server"],
        "env": {
          "ROLLBAR_PROJECT_TOKEN": "YOUR_PROJECT_ACCESS_TOKEN",
          "ROLLBAR_ACCOUNT_TOKEN": "YOUR_ACCOUNT_ACCESS_TOKEN",
          "ROLLBAR_PROJECT_ID": "YOUR_PROJECT_ID",
          "ROLLBAR_PROJECT_NAME": "YOUR_PROJECT_NAME"
        }
      }
    }
}

'server name': 'rollbar-mcp' (服务器名称，可以自定义)
'command': 'npx' (使用 npx 命令运行 npm 包)
'args': '["-y", "@hiyorineko/mcp-rollbar-server"]' (指定要运行的 npm 包，'-y' 参数用于自动确认安装)
'env': 环境变量配置
- 'ROLLBAR_PROJECT_TOKEN': 必需。Rollbar 项目访问令牌，用于访问项目级别的错误和部署信息。
- 'ROLLBAR_ACCOUNT_TOKEN': 必需。Rollbar 账户访问令牌，用于访问账户级别的项目和用户信息。
- 'ROLLBAR_PROJECT_ID': 可选。默认项目 ID，当请求中未指定项目 ID 时使用。
- 'ROLLBAR_PROJECT_NAME': 可选。默认项目名称，用于参考。

本地构建后运行:

{
    "mcpServers": {
      "rollbar-mcp": {
        "command": "YOUR_NODE_PATH",
        "args": ["YOUR_PROJECT_PATH/mcp-rollbar-server/dist/src/index.js"],
        "env": {
          "ROLLBAR_PROJECT_TOKEN": "YOUR_PROJECT_ACCESS_TOKEN",
          "ROLLBAR_ACCOUNT_TOKEN": "YOUR_ACCOUNT_TOKEN",
          "ROLLBAR_PROJECT_ID": "YOUR_PROJECT_ID",
          "ROLLBAR_PROJECT_NAME": "YOUR_PROJECT_NAME"
        }
      }
    }
}

'server name': 'rollbar-mcp' (服务器名称，可以自定义)
'command': 'YOUR_NODE_PATH' (Node.js 可执行文件的路径，例如 '/usr/bin/node'，可以使用 'which node' 命令查找)
'args': '["YOUR_PROJECT_PATH/mcp-rollbar-server/dist/src/index.js"]' (指定服务器入口文件路径，需要替换为实际的项目路径)
'env': 环境变量配置 (同上)

获取 Rollbar 访问令牌:

登录 Rollbar 账户 (https://rollbar.com/)
项目令牌: 进入 "Settings" -> "Project Access Tokens" (项目级别访问)
账户令牌: 进入 "Settings" -> "Account Access Tokens" (账户级别访问)
创建新的访问令牌，Scope 选择 "read" 权限。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，即可通过自然语言指令调用 Rollbar MCP Server 提供的工具，例如：

"列出我生产环境最近的错误"
"查看 ID 为 12345 的错误详情"
"展示项目 67890 的近期部署"
"筛选过去一周发生的 critical 级别的错误"

具体工具和参数请参考仓库 'README.md' 文件中 "Tools" 部分的详细描述。

关键词