Rollbar MCP 服务器

用于 Rollbar API 集成的 MCP 服务器实现，使 LLM 能够与 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_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。

使用示例

列出我的生产环境中最近的错误。

查看错误详情

获取 ID 为 12345 的错误项的详细信息，包括堆栈跟踪和最近的发生。

跟踪部署

显示项目 67890 的最近部署。

按级别筛选错误

列出过去一周发生的所有严重错误。

工具

rollbar_list_items

从 Rollbar 列出项目（错误）

• 输入:
  • status (string, optional): 按状态筛选（active、resolved、muted 等）
  • level (string, optional): 按级别筛选（critical、error、warning、info、debug）
  • environment (string, optional): 按环境筛选（production、staging 等）
  • limit (number, optional): 要返回的最大项目数（默认值：20）
  • page (number, optional): 分页的页码（默认值：1）
• 返回: 错误项目列表，包含计数器、级别、总发生次数等详细信息。

rollbar_get_item

从 Rollbar 获取特定项目（错误）

• 输入:
  • id (number): 项目 ID
• 返回: 关于特定错误项目的详细信息

rollbar_list_occurrences

从 Rollbar 列出错误的发生

• 输入:
  • itemId (number, optional): 用于筛选发生的项目 ID
  • limit (number, optional): 要返回的最大发生次数（默认值：20）
  • page (number, optional): 分页的页码（默认值：1）
• 返回: 错误发生列表，包含详细信息

rollbar_get_occurrence

从 Rollbar 获取错误的特定发生

• 输入:
  • id (string): 发生 ID
• 返回: 关于特定错误发生的详细信息

rollbar_list_projects

从 Rollbar 列出项目

• 输入: 无
• 返回: 项目列表，包含其 ID、名称和状态

rollbar_get_project

从 Rollbar 获取特定项目

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

rollbar_list_environments

从 Rollbar 列出环境

• 输入:
  • projectId (number): 项目 ID
• 返回: 指定项目的环境列表

rollbar_list_users

从 Rollbar 列出用户

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

rollbar_get_user

从 Rollbar 获取特定用户

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

rollbar_list_deploys

从 Rollbar 列出部署

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

rollbar_get_deploy

从 Rollbar 获取特定部署

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