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