Mindscapehq MCP Server Raygun

🚀 Raygun MCP サーバー

RaygunのAPI V3エンドポイントのMCPサーバーです。このサーバーを使用すると、クラッシュレポートやリアルユーザーモニタリングアプリケーションとのやり取りが可能です。モデルコンテキストプロトコルを通じて、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 - エラー指標の時系列データを取得します。

ソースマップ

• 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 - 保留中の招待を取り消します。

🔧 設定

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

• 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

📦 インストール

Claude Desktopで使用する場合、サーバー設定を追加します。

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

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

🐞 デバッグ

上記の設定が完了したら、以下のコマンドを実行してサーバーを起動します。

npm run start

環境変数 RAYGUN_PAT_TOKEN が正しく設定されていることを確認してください。