Bugsnag MCP Server

Bugsnag MCP サーバー

Bugsnag と連携するための Model Context Protocol（MCP）サーバーです。このサーバーを使うと、Cursor や Claude などの LLM ツールで Bugsnag の問題を調査、解決できます。

✨ 機能

エラーの監視と分析

• 組織とプロジェクトのナビゲーション：Bugsnag の階層を簡単に閲覧できます
• エラーとイベントのフィルタリング：強力なフィルタリングオプションを使って、特定の問題を見つけられます
• 詳細なスタックトレースの表示：ソースコードのコンテキストとエラー行のハイライトを含む、整形されたスタックトレースを確認できます
• 例外チェーンの可視化：例外チェーン全体を表示して、根本原因を把握できます

コードインテリジェンス

• プロジェクトコードとライブラリコードの区別：自分のコードとサードパーティライブラリを明確に識別できます
• ソースコードのコンテキスト：エラー箇所周辺の関連するコードスニペットを表示できます
• エラーパターン：複数のエラーにまたがる繰り返しのパターンを特定できます

問題の管理

• 検索機能：エラークラス、メッセージ、アプリのバージョンで問題を検索できます
• エラーの詳細：各エラーに関する包括的な情報を取得できます
• イベント履歴：特定のエラーのすべての発生を確認できます

🚀 クイックセットアップ

Bugsnag MCP サーバーのセットアップは簡単で、インストールやソースコードのダウンロードは不要です。

Cursor の場合

1. Bugsnag MCP サーバーの設定を追加します：

   {
     "mcpServers": {
       "bugsnag": {
         "command": "npx",
         "args": ["-y", "bugsnag-mcp-server"],
         "env": {
           "BUGSNAG_API_KEY": "your-bugsnag-api-key"
         },
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }
   

2. your-bugsnag-api-key を Bugsnag API キーに置き換えます

Claude Desktop の場合

1. Bugsnag MCP サーバーの設定を追加します：

   {
     "mcpServers": {
       "bugsnag": {
         "command": "npx",
         "args": ["-y", "bugsnag-mcp-server"],
         "env": {
           "BUGSNAG_API_KEY": "your-bugsnag-api-key"
         },
         "disabled": false,
         "alwaysAllow": []
       }
     }
   }
   

2. your-bugsnag-api-key を Bugsnag API キーに置き換えます

🔑 Bugsnag API キーの取得

この MCP サーバーを使用するには、Bugsnag API キーが必要です：

1. https://app.bugsnag.com/ で Bugsnag アカウントにログインします
2. Settings > Organization settings > Access tokens に移動します
3. 次の権限を持つ新しい個人用アクセストークンを作成します：
   • プロジェクトの読み取り
   • エラーの読み取りと書き込み
   • コメントの読み取りと書き込み
4. 生成されたトークンをコピーし、MCP サーバーで使用します

📋 使用例

設定が完了したら、LLM ツールで Bugsnag MCP サーバーを使用できます。プロンプトの例を以下に示します：

Bugsnag アカウントを調べる

List all my Bugsnag organizations

Show me all projects in organization "org_12345"

エラーを見つけて分析する

List the open errors in my Bugsnag project "project_12345"

Show me the details for Bugsnag error ID "error_12345"

Show me the detailed stacktrace for event "event_12345" in project "project_12345"

View the exception chain for event "event_12345" in project "project_12345"

特定の問題を検索する

Search for Bugsnag issues in project "project_12345" related to "NullPointerException"

List all events for error "error_12345" in project "project_12345"

📚 利用可能なツール

Bugsnag MCP サーバーでは、次のツールを利用できます：

組織とプロジェクトの管理

list_organizations

利用可能な Bugsnag 組織の一覧を取得します。

パラメーター：

• 必須項目なし

list_projects

組織内のプロジェクト一覧を取得します。

パラメーター：

• organization_id（必須）：Bugsnag の組織 ID

エラーとイベントの管理

list_errors

フィルタリングオプションを使って、プロジェクト内のエラー一覧を取得します。

パラメーター：

• project_id（必須）：Bugsnag のプロジェクト ID
• status：エラーのステータスでフィルタリングします（"open"、"fixed"、"ignored"）
• sort：エラーの並び順（"newest"、"oldest"、"priority"）
• limit：取得するエラーの最大数

view_error

特定のエラーの詳細情報を取得します。

パラメーター：

• error_id（必須）：Bugsnag のエラー ID

list_error_events

特定のエラーのイベント（発生）一覧を取得します。

パラメーター：

• project_id（必須）：Bugsnag のプロジェクト ID
• error_id（必須）：Bugsnag のエラー ID
• limit：取得するイベントの最大数

view_latest_event

エラーの最新イベントを表示します。

パラメーター：

• error_id（必須）：Bugsnag のエラー ID

view_event

特定のイベントの詳細情報を表示します。

パラメーター：

• project_id（必須）：Bugsnag のプロジェクト ID
• event_id（必須）：Bugsnag のイベント ID

スタックトレース分析

view_stacktrace

イベントからスタックトレース情報を抽出して整形します。

パラメーター：

• project_id（必須）：Bugsnag プロジェクト ID
• event_id（必須）：Bugsnag イベント ID
• include_code：利用可能な場合にソースコードのコンテキストを含めます（デフォルト：true）

view_exception_chain

イベントの例外チェーン全体を表示します。

パラメーター：

• project_id（必須）：Bugsnag プロジェクト ID
• event_id（必須）：Bugsnag イベント ID

イシュー管理

search_issues

さまざまな条件を使ってイシューを検索します。

パラメーター：

• project_id（必須）：Bugsnag プロジェクト ID
• query：検索クエリ
• error_class：エラークラスで絞り込み
• app_version：アプリのバージョンで絞り込み

🛠️ 高度な使い方

API キーのテスト

次のコマンドを使用して、Bugsnag API キーが有効かどうかをテストできます。

npx bugsnag-mcp-server test-api-key your-bugsnag-api-key

API キーが有効な場合、Bugsnag プロジェクトの ID 一覧が表示されます。

インストール方法

ほとんどのユーザーには npx の使用をおすすめしますが、必要に応じてパッケージをグローバルにインストールすることもできます。

npm install -g bugsnag-mcp-server

開発者向け

コードへの貢献や変更に関心がある場合は、次の手順に従ってください。

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/bugsnag-mcp.git
   cd bugsnag-mcp
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. テストを実行します。

   npm test
   

5. カバレッジ付きでテストを実行します。

   npm run test:coverage
   

6. コードをフォーマットします。

npm run format

7. コードのフォーマットを確認します。

npm run format:check

継続的インテグレーション

このプロジェクトでは、継続的インテグレーションに GitHub Actions を使用しています。ワークフローは次の処理を自動的に実行します。

• main ブランチへのプッシュ時とプルリクエスト時に実行
• 複数の Node.js バージョン（18.x および 20.x）でテスト
• テストスイートを実行
• テストカバレッジレポートを生成してアップロード
• Prettier でコードのフォーマットを確認

ワークフロー設定は次の場所で確認できます。

• .github/workflows/test.yml - テストの実行用
• .github/workflows/prettier.yml - コードのフォーマット確認用

ライセンス

MIT