Rollbar MCP Server

Rollbar MCP 服务器

Rollbar API 集成的动态 MCP 服务器实现，可让大模型与 Rollbar 错误跟踪数据交互。

功能

• 列出并筛选错误条目
• 获取详细的错误信息
• 查看错误发生记录
• 访问项目和环境详情
• 跟踪部署
• 列出用户和团队

配置

环境变量

• ROLLBAR_PROJECT_TOKEN：Rollbar 项目访问令牌——API 检索项目错误和部署信息所必需
• ROLLBAR_ACCOUNT_TOKEN：Rollbar 账户访问令牌——API 访问整个账户范围内的项目和用户信息所必需
• ROLLBAR_PROJECT_ID：默认项目 ID（在请求中未指定时使用）——可选
• ROLLBAR_PROJECT_NAME：用于参考的默认项目名称——可选

注意：根据使用的功能，你需要配置 ROLLBAR_PROJECT_TOKEN、ROLLBAR_ACCOUNT_TOKEN，或两者。 若要使用全部功能，建议配置这两个令牌；但对于特定 API，只配置相关令牌也能使用服务。

必需令牌与 API 对应表

API	必需令牌
rollbar_list_items	ROLLBAR_PROJECT_TOKEN
rollbar_get_item	ROLLBAR_PROJECT_TOKEN
rollbar_get_item_by_counter	ROLLBAR_PROJECT_TOKEN
rollbar_list_occurrences	ROLLBAR_PROJECT_TOKEN
rollbar_get_occurrence	ROLLBAR_PROJECT_TOKEN
rollbar_list_environments	ROLLBAR_PROJECT_TOKEN
rollbar_list_deploys	ROLLBAR_PROJECT_TOKEN
rollbar_get_deploy	ROLLBAR_PROJECT_TOKEN
rollbar_list_projects	ROLLBAR_ACCOUNT_TOKEN
rollbar_get_project	ROLLBAR_ACCOUNT_TOKEN
rollbar_list_users	ROLLBAR_ACCOUNT_TOKEN
rollbar_get_user	ROLLBAR_ACCOUNT_TOKEN

获取 Rollbar 访问令牌的方法：

1. 登录 Rollbar 账户（https://rollbar.com/）
2. 对于项目令牌：Settings -> Project Access Tokens（用于项目级访问）
3. 对于账户令牌：Settings -> Account Access Tokens（用于账户级访问）
4. 创建一个具有“read”权限范围的新令牌

使用方法

Cursor 集成

添加到 ~/.cursor/mcp.json：

{
    "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"
        }
      }
    }
}

本地使用

克隆此仓库后，按照以下步骤设置 MCP 客户端：

$ cd mcp-rollbar-server
$ npm install
$ npm run build

添加到 ~/.cursor/mcp.json：

{
    "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_ACCESS_TOKEN",
          "ROLLBAR_PROJECT_ID": "YOUR_PROJECT_ID",
          "ROLLBAR_PROJECT_NAME": "YOUR_PROJECT_NAME"
        }
      }
    }
}

要查找 "YOUR_NODE_PATH" 的值，请在终端中运行 which node。

使用示例

List the most recent errors in my production environment.

查看错误详情

Get detailed information for error item with ID 12345, including stack trace and recent occurrences.

跟踪部署

Show me the recent deployments for project 67890.

按级别筛选错误

List all critical errors that occurred in the last week.

工具

rollbar_list_items

列出 Rollbar 中的条目（错误）

• 输入：
  • status（字符串，可选）：按状态筛选（active、resolved、muted 等）
  • level（字符串，可选）：按级别筛选（critical、error、warning、info、debug）
  • environment（字符串，可选）：按环境筛选（production、staging 等）
  • limit（数字，可选）：返回的最大条目数（默认值：20）
  • page（数字，可选）：分页页码（默认值：1）
• 返回：错误条目列表，包含计数器、级别、发生总次数等详情

rollbar_get_item

使用 Rollbar 系统维护的内部条目 ID，从 Rollbar 获取指定条目（错误）。

• 输入：
  • id（数字）：条目 ID
• 返回：指定错误条目的详细信息

rollbar_get_item_by_counter

通过项目计数器从 Rollbar 获取指定条目。该计数器是在 Rollbar UI 中显示的 ID。

• 输入：
  • counter（数字）：条目的项目计数器
• 返回：由项目计数器标识的指定错误条目的详细信息

rollbar_list_occurrences

列出 Rollbar 中的错误发生记录

• 输入：
  • itemId（number，可选）：用于筛选发生记录的 Item ID
  • limit（number，可选）：要返回的发生记录数量上限（默认值：20）
  • page（number，可选）：分页页码（默认值：1）
• 返回：包含详细信息的错误发生记录列表

rollbar_get_occurrence

获取 Rollbar 中某个特定错误的发生记录

• 输入：
  • id（string）：发生记录 ID
• 返回：某个特定错误发生记录的详细信息

rollbar_list_projects

列出 Rollbar 中的项目

• 输入：无
• 返回：包含项目 ID、名称和状态的项目列表

rollbar_get_project

获取 Rollbar 中的某个特定项目

• 输入：
  • id（number）：项目 ID
• 返回：某个特定项目的详细信息

rollbar_list_environments

列出环境

• 输入：
  • projectId（number）：项目 ID
• 返回：指定项目的环境列表

rollbar_list_users

列出 Rollbar 中的用户

• 输入：无
• 返回：包含用户 ID、用户名、电子邮件和访问级别的用户列表

rollbar_get_user

获取 Rollbar 中的某个特定用户

• 输入：
  • id（number）：用户 ID
• 返回：某个特定用户的详细信息

rollbar_list_deploys

列出 Rollbar 中的部署

• 输入：
  • projectId（number）：项目 ID
  • environment（string，可选）：环境名称
  • limit（number，可选）：要返回的部署数量上限（默认值：20）
  • page（number，可选）：分页页码（默认值：1）
• 返回：指定项目和环境的部署列表

rollbar_get_deploy

获取 Rollbar 中的某个特定部署

• 输入：
  • deployId（number）：部署 ID
• 返回：某个特定部署的详细信息