🚀 雷枪MCP服务器

雷枪MCP服务器基于API V3端点，用于与您的错误报告和真实用户监控应用程序进行交互。借助模型上下文协议，该服务器能让您全面使用雷枪的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（必需）：您的 雷枪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-ken"
      }
    }
  }
}

开发

安装依赖

npm install

构建服务器

npm run build

带有自动重建的开发

npm run watch

调试

由于MCP服务器通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP Inspector，它作为包脚本可用：

npm run inspector

Inspector会提供一个访问浏览器调试工具的URL。