Rollbar MCP Server

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_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. プロジェクトトークンの場合：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 を実行します。

使用例

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 (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

環境の一覧を表示します

• 入力：
  • 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
• 戻り値：特定のデプロイの詳細