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