ロールバー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_get_item`	ロールバープロジェクトトークン
`rollbar_get_item_by_counter`	ロールバープロジェクトトークン
`rollbar_list_occurrences`	ロールバープロジェクトトークン
`rollbar_get_occurrence`	ロールバープロジェクトトークン
`rollbar_list_environments`	ロールバープロジェクトトークン
`rollbar_list_deploys`	ロールバープロジェクトトークン
`rollbar_get_deploy`	ロールバープロジェクトトークン
`rollbar_list_projects`	ロールバーアカウントトークン
`rollbar_get_project`	ロールバーアカウントトークン
`rollbar_list_users`	ロールバーアカウントトークン
`rollbar_get_user`	ロールバーアカウントトークン

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」の値を見つけるには、ターミナルで 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 からリスト項目 (エラー) を取得します

入力：
- status （文字列、オプション）：ステータス（アクティブ、解決済み、ミュートなど）でフィルタリングします。
- level （文字列、オプション）：レベル（クリティカル、エラー、警告、情報、デバッグ）でフィルタリング
- environment (文字列、オプション): 環境 (本番、ステージングなど) でフィルタリングします。
- limit (数値、オプション): 返されるアイテムの最大数 (デフォルト: 20)
- page （数値、オプション）：ページ区切りのページ番号（デフォルト：1）
返される値: カウンター、レベル、発生回数などの詳細を含むエラー項目のリスト。

ロールバー_get_item

Rollbar のシステムによって管理されている内部アイテム ID を使用して、Rollbar から特定のアイテム (エラー) を取得します。

入力：
- id (数値): アイテムID
戻り値: 特定のエラー項目に関する詳細情報

ロールバー_カウンターによるアイテム取得

Rollbarからプロジェクトカウンターで特定のアイテムを取得します。カウンターはRollbar UIに表示されるIDです。

入力：
- counter （数値）：アイテムのプロジェクトカウンター
戻り値: プロジェクトカウンタで識別される特定のエラー項目に関する詳細情報

ロールバーリスト発生回数

ロールバーからのエラー発生を一覧表示する

入力：
- itemId (数値、オプション): 出現をフィルタリングするアイテムID
- limit (数値、オプション): 返される出現回数の最大値 (デフォルト: 20)
- page （数値、オプション）：ページ区切りのページ番号（デフォルト：1）
戻り値: 詳細情報を含むエラー発生のリスト

ロールバー_get_occurrence

Rollbarから特定のエラー発生を取得する

入力：
- id (文字列): 発生ID
戻り値: 特定のエラー発生に関する詳細情報

ロールバー_リスト_プロジェクト

Rollbarからのプロジェクト一覧

入力: なし
戻り値: ID、名前、ステータスを含むプロジェクトのリスト

ロールバー_get_project

Rollbarから特定のプロジェクトを取得する

入力：
- id (数字): プロジェクトID
戻り値: 特定のプロジェクトに関する詳細情報

ロールバーリスト環境

Rollbar から環境をリストする

入力：
- projectId (数値): プロジェクトID
戻り値: 指定されたプロジェクトの環境のリスト

ロールバーリストユーザー

Rollbarからのユーザー一覧

入力: なし
返されるもの: ID、ユーザー名、メールアドレス、アクセスレベルを持つユーザーのリスト

ロールバー_get_user

Rollbarから特定のユーザーを取得する

入力：
- id (数字): ユーザーID
返されるもの: 特定のユーザーに関する詳細情報

ロールバーリストの展開

Rollbarからのデプロイをリストする

入力：
- projectId (数値): プロジェクトID
- environment （文字列、オプション）: 環境名
- limit (数値、オプション): 返されるデプロイの最大数 (デフォルト: 20)
- page （数値、オプション）：ページ区切りのページ番号（デフォルト：1）
戻り値: 指定されたプロジェクトと環境のデプロイのリスト

ロールバーの取得と展開

Rollbarから特定のデプロイを取得する

入力：
- deployId (数値): デプロイID
戻り値: 特定のデプロイメントに関する詳細情報