Sentry MCP Server 使用说明

项目简介

本项目是 Sentry 的 Model Context Protocol (MCP) 服务器实现,旨在为 AI 助手提供与 Sentry API 交互的能力。通过此 MCP 服务器,AI 助手可以检索和分析 Sentry 的错误数据,管理项目,并监控应用程序性能。

主要功能点

  • 项目管理:列出 Sentry 组织中的项目、创建新项目。
  • 问题追踪:检索和分析 Sentry 问题详情、事件详情,通过短ID解析问题。
  • 错误监控:列出项目中的错误事件、问题事件,搜索特定文件的错误。
  • 性能监控:列出 Sentry 组织中的 Replays (用户会话回放),用于分析用户体验问题。
  • Sentry 设置:快速为项目设置 Sentry,获取 DSN 和安装指南。

安装步骤

  1. 确保已安装 Node.js (v14 或更高版本) 和 npm 或 yarn。
  2. 克隆此 GitHub 仓库到本地。
  3. 在终端中进入仓库根目录。
  4. 运行 'npm install' 安装项目依赖。

服务器配置

要将此 MCP 服务器与 MCP 客户端(如 Claude)配合使用,请在客户端中添加以下服务器配置。

{
    "mcpServers": {
        "sentry": {
            "command": "npx",
            "args": ["ts-node", "/path/to/sentry-mcp-ts/index.ts"],
            "env": {
                "SENTRY_AUTH": "<YOUR_SENTRY_AUTH_TOKEN>"
            }
        }
    }
}

配置参数说明:

  • 'server name': 'sentry' (服务器名称,客户端用于标识和调用)
  • 'command': 'npx' (运行服务器的命令)
  • 'args': '["ts-node", "/path/to/sentry-mcp-ts/index.ts"]' (命令参数,'ts-node' 用于运行 TypeScript 代码,'/path/to/sentry-mcp-ts/index.ts' 请替换为实际仓库 index.ts 文件的绝对路径)
  • 'env': '{"SENTRY_AUTH": "<YOUR_SENTRY_AUTH_TOKEN>"}' (环境变量,'SENTRY_AUTH' 是 Sentry API 认证 Token,请替换为您的 Sentry 认证 Token)

基本使用方法

  1. 启动 MCP 服务器:在仓库根目录运行 'npx ts-node index.ts'。
  2. 在 MCP 客户端中配置并连接到 'sentry' 服务器。
  3. 在客户端中使用提供的工具(例如 'list_projects', 'resolve_short_id' 等)与 Sentry 进行交互。工具的具体使用方法和参数请参考每个工具的描述信息。

注意: 使用前请确保已在 Sentry 账户中生成 API 访问 Token,并赋予 Token 相应的权限。

信息

分类

开发者工具