MCP错误追踪服务器

Name: MCP错误追踪服务器
Author: hiyorineko

作者：hiyorineko6 星标更新：2025-04-18

安装使用来源：spider==github.com

项目介绍

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 访问令牌：

登录您的 Rollbar 账户（https://rollbar.com/）
对于项目令牌：设置 -> 项目访问令牌（针对项目级别访问）
对于账户令牌：设置 -> 账户访问令牌（针对账户级别访问）
创建一个具有“读取”权限的新令牌

如何使用

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

rollbar_get_item

通过 Rollbar 系统维护的内部项目ID获取特定项目（错误）

输入：
- 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
返回：特定部署的详细信息