Raygun MCP Server 使用说明

项目简介

Raygun MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它为大型语言模型 (LLM) 客户端提供了一系列工具，用于访问和操作 Raygun API V3 的数据。Raygun 是一款强大的应用程序监控平台，用于错误跟踪、性能监控和用户行为分析。通过此 MCP Server，LLM 可以集成 Raygun 的功能，例如检索应用信息、管理错误组、查看部署信息、监控性能指标和处理 Source Map 等。

主要功能点

应用管理: 列出、获取和管理 Raygun 应用程序的信息，包括应用密钥的再生。
错误管理: 查询、查看、解决、激活、忽略和永久忽略 Raygun 错误组。
部署管理: 列出、获取、删除和更新 Raygun 部署信息，并能重新处理部署提交。
用户与会话管理: 列出 Raygun 客户和用户会话，并获取详细会话信息。
性能监控: 检索页面性能指标的时间序列数据和直方图数据。
Source Map 管理: 管理 Raygun Source Map，包括上传、查看、更新和删除 Source Map。
团队邀请管理: 列出、发送、获取和撤销团队邀请。

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm。

克隆仓库: 将仓库 'MindscapeHQ_mcp-server-raygun' 克隆到本地。

git clone https://github.com/MCP-Mirror/MindscapeHQ_mcp-server-raygun.git
cd MindscapeHQ_mcp-server-raygun

安装依赖: 在仓库根目录下运行以下命令安装项目依赖。
```
npm install
```
构建项目: 运行以下命令构建项目。
```
npm run build
```

服务器配置

MCP 客户端需要配置 Raygun MCP Server 的启动命令才能连接。以下是 Claude Desktop 客户端的配置示例，其他 MCP 客户端的配置方式类似。

在 Claude Desktop 的 'claude_desktop_config.json' 文件中，添加如下 'mcpServers' 配置：

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

配置参数说明:

'server name': 'raygun' (服务器名称，可以自定义)
'command': 'npx' (Node.js 包执行器，确保 npx 已安装)
'args': '["-y", "@raygun.io/mcp-server-raygun"]' (启动服务器的参数，'-y' 参数用于跳过 npm 包安装时的确认提示，'@raygun.io/mcp-server-raygun' 是发布的 npm 包名称)
'env': 环境变量配置
- 'RAYGUN_PAT_TOKEN': 必填。您的 Raygun Personal Access Token (PAT)。您需要在 Raygun 控制台中生成 PAT Token 并替换 '"your-raygun-pat-token"'。

或者，您也可以直接运行构建后的 JavaScript 文件:

如果您不想使用 'npx' 或者需要更精细的控制，可以使用以下配置，直接运行构建后的服务器 JavaScript 文件。您需要将 'command' 路径指向 'build/index.js' 文件的绝对路径。

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

配置参数说明:

'command': '/path/to/MindscapeHQ_mcp-server-raygun/build/index.js' (服务器启动命令，请替换为实际的 'build/index.js' 文件路径)
'env': 环境变量配置，与上述 'npx' 方式相同。

环境变量 'SOURCEMAP_ALLOWED_DIRS' (可选): 如果您需要使用 Source Map 相关的功能（如上传 Source Map），可以设置 'SOURCEMAP_ALLOWED_DIRS' 环境变量。该变量的值为逗号分隔的目录列表，用于限制 Source Map 文件操作的允许目录，增加安全性。

基本使用方法

启动 MCP 客户端: 启动配置了 Raygun MCP Server 的 MCP 客户端 (例如 Claude Desktop)。
调用工具: 在 MCP 客户端中，您可以通过自然语言指令或图形界面来调用 Raygun MCP Server 提供的工具。例如，您可以询问 "列出我的 Raygun 应用" 或 "获取应用 ID 为 xxx 的应用信息"。
获取 Raygun 数据: 服务器会将请求转换为 Raygun API V3 的调用，并将结果返回给 MCP 客户端。您可以在客户端界面中查看和使用 Raygun 的数据。

调试: 如果遇到问题，可以使用 'npm run inspector' 命令启动 MCP Inspector 进行调试。Inspector 提供了一个 Web 界面，可以帮助您查看 MCP 客户端和服务器之间的通信。

mcp server raygun