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