Raygun

🚀 Raygun MCP 服務器

Raygun MCP 服務器是基於 Raygun 的 API V3 端點構建的，可用於與錯誤報告和真實用戶監控應用程序進行交互。通過模型上下文協議（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 - 撤銷待處理的邀請

📦 安裝指南

配置環境變量

服務器需要以下環境變量：

• 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"
      }
    }
  }
}

不同系統的配置文件路徑如下：

• 在 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"
      }
    }
  }
}

開發環境安裝

安裝依賴

npm install

構建服務器

npm run build

開發時自動重建

npm run watch

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們推薦使用 MCP 檢查器，這是一個可用的包腳本：

npm run inspector

檢查器將在瀏覽器中提供一個訪問調試工具的 URL。

💻 使用示例

使用 Claude Desktop

將以下配置添加到 claude_desktop_config.json 中，即可使用 Raygun MCP 服務器：

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