Rollbar MCP 服务器

一个动态的MCP服务器实现，用于Rollbar API集成，使LLMs能够与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. 对于项目令牌：设置 -> 项目访问令牌（针对项目级访问）
3. 对于账户令牌：设置 -> 账户访问令牌（针对账户级访问）
4. 创建一个新的具有“读取”范围的令牌

如何使用

光标集成

添加到你的~/.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 (数字, 可选)：用于过滤实例的项目 ID
  • limit (数字, 可选)：要返回的最大实例数（默认值: 20）
  • page (数字, 可选)：分页的页码（默认值: 1）
• 返回：带有详细信息的错误实例列表

rollbar_get_occurrence

从 Rollbar 获取特定错误的实例

• 输入：
  • id (字符串)：实例 ID
• 返回：关于特定错误实例的详细信息

rollbar_list_projects

列出 Rollbar 中的项目

• 输入：无
• 返回：带有其 ID、名称和状态的项目列表

rollbar_get_project

从 Rollbar 获取特定项目

• 输入：
  • id (数字)：项目 ID
• 返回：关于特定项目的详细信息

rollbar_list_environments

列出 Rollbar 中的环境

• 输入：
  • projectId (数字)：项目 ID
• 返回：指定项目的环境列表

rollbar_list_users

列出 Rollbar 中的用户

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

rollbar_get_user

从 Rollbar 获取特定用户

• 输入：
  • id (数字)：用户 ID
• 返回：关于特定用户的详细信息

rollbar_list_deploys

列出 Rollbar 中的部署

• 输入：
  • projectId (数字)：项目 ID
  • environment (字符串, 可选)：环境名称
  • limit (数字, 可选)：要返回的最大部署数量（默认值: 20）
  • page (数字, 可选)：分页的页码（默认值: 1）
• 返回：指定项目和环境的部署列表

rollbar_get_deploy

从 Rollbar 获取特定部署

• 输入：
  • deployId (数字)：部署 ID
• 返回：关于特定部署的详细信息