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 对应的令牌。

所需Token及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 访问令牌：

登录您的 Rollbar 帐户（ https://rollbar.com/ ）
对于项目令牌：设置 -> 项目访问令牌（用于项目级访问）
对于帐户令牌：设置 -> 帐户访问令牌（用于帐户级别访问）
创建具有“读取”范围的新令牌

如何使用

光标集成

添加到您的~/.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”的值，请在终端中运行哪个节点。

使用示例

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 （字符串，可选）：按状态过滤（活动、已解决、静音等）
- level （字符串，可选）：按级别过滤（严重、错误、警告、信息、调试）
- environment （字符串，可选）：按环境过滤（生产、暂存等）
- limit （数字，可选）：返回的最大项目数（默认值：20）
- page （数字，可选）：分页的页码（默认值：1）
返回：错误项列表，其中包含计数器、级别、总发生次数等详细信息。

rollbar_get_item

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

输入：
- id （数字）：商品 ID
返回：有关特定错误项的详细信息

rollbar_get_item_by_counter

从 Rollbar 获取按项目计数器指定的项目。计数器是 Rollbar 界面中显示的可见 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
返回：有关特定部署的详细信息