Raygun

🚀 Raygun MCP サーバー

Raygun の API V3 エンドポイントの MCP サーバーです。このサーバーを使用すると、エラーレポートやリアルユーザーモニタリングアプリケーションとやり取りすることができます。また、モデルコンテキストプロトコル（Model Context Protocol）を通じて、Raygun API の機能を完全に利用することができます。

✨ 主な機能

ツール

アプリケーション

• list_applications - アカウントに関連付けられたすべてのアプリケーションをリストします。
• get_application - 識別子を使用してアプリケーションの詳細情報を取得します。
• get_application_by_api_key - API キーを使用してアプリケーションの詳細情報を取得します。
• regenerate_application_api_key - アプリケーションの新しい API キーを生成します。

エラー管理

• list_error_groups - アプリケーションのエラーグループをリストします。
• get_error_group - エラーグループの詳細情報を取得します。
• resolve_error_group - エラーグループの状態を「解決済み」に設定します。
• activate_error_group - エラーグループの状態を「アクティブ」に設定します。
• ignore_error_group - エラーグループの状態を「無視」に設定します。
• permanently_ignore_error_group - エラーグループの状態を「永久に無視」に設定します。

デプロイ管理

• list_deployments - アプリケーションのデプロイをリストします。
• get_deployment - 識別子を使用してデプロイの詳細情報を取得します。
• delete_deployment - デプロイを削除します。
• update_deployment - デプロイ情報を更新します。
• reprocess_deployment_commits - デプロイコミットデータを再処理します。

ユーザーとセッション管理

• list_customers - アプリケーションの顧客をリストします。
• list_sessions - アプリケーションのユーザーセッションをリストします。
• get_session - セッションの詳細情報を取得します。

パフォーマンスモニタリング

• list_pages - モニタリング対象のページをリストします。
• get_page_metrics_time_series - パフォーマンス指標の時系列データを取得します。
• get_page_metrics_histogram - パフォーマンス指標のヒストグラムデータを取得します。
• get_error_metrics_time_series - エラー指標の時系列データを取得します。

ソースマップ（Source Maps）

• list_source_maps - アプリケーションのソースマップをリストします。
• get_source_map - ソースマップの詳細情報を取得します。
• update_source_map - ソースマップ情報を更新します。
• delete_source_map - ソースマップを削除します。
• upload_source_map - 新しいソースマップをアップロードします。
• delete_all_source_maps - すべてのソースマップを削除します。

チーム管理

• list_invitations - 保留中のチーム招待をリストします。
• send_invitation - 新しいチーム招待を送信します。
• get_invitation - 招待の詳細情報を取得します。
• revoke_invitation - 保留中の招待を取り消します。

📦 インストール

Claude Desktop と併用する場合は、以下の設定を追加してください。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "raygun": {
      "command": "/path/to/server-raygun/build/index.js",
      "env": {
        "RAYGUN_PAT_TOKEN": "your-pat-token-here"
      }
    }
  }
}

デバッグ

MCP サーバーは標準入出力を通じて通信するため、デバッグは難しい場合があります。MCP インスペクターを使用することをおすすめします。これは利用可能なパッケージスクリプトです。

npm run inspector

インスペクターはブラウザでデバッグツールにアクセスするための URL を提供します。

🔧 設定

サーバーには以下の環境変数が必要です。

• RAYGUN_PAT_TOKEN（必須）：Raygun PAT トークン
• SOURCEMAP_ALLOWED_DIRS（任意）：ソースマップ操作を許可するディレクトリのカンマ区切りリスト

💻 使用例

基本的な使用法

Claude Desktop で使用するには、以下の内容を claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "raygun": {
      "command": "npx",
      "args": ["-y", "@raygun.io/mcp-server-raygun"],
      "env": {
        "RAYGUN_PAT_TOKEN": "your-pat-token-here"
      }
    }
  }
}

🔨 開発

依存関係をインストール：

npm install

サーバーをビルド：

npm run build

自動再構築を使用して開発：

npm run watch