Sentry MCP Server

注意 - 该项目在很大程度上已被 Sentry Remote-MCP Server 取代，后者支持更多功能（身份验证、更完善的工具等）。本项目作为独立的 MCP 服务保留，用于教学目的；但大多数情况下，你会想使用远程服务。你可以在 https://mcp.sentry.dev 查看其实际运行情况。

Sentry MCP 服务

用于与 Sentry 交互的 Model Context Protocol（MCP）服务。此 MCP 服务提供了与 Sentry API 交互的工具，允许 AI 助手检索和分析错误数据、管理项目并监控应用性能。

要求

• Node.js（v14 或更高版本）
• npm 或 yarn
• 拥有 API 访问权限的 Sentry 账户
• 具有适当权限的 Sentry 身份验证令牌

设置

1. 安装依赖项：

   npm install
   

在 IDE 中使用

此 MCP 已验证可与 Cursor、Codeium Windsurf 和 Claude Desktop 配合使用。

与 Claude 配合使用

若要将此 MCP 服务与 Claude 配合使用，请将以下配置添加到 Claude 设置中：

{
    "mcpServers": {
        "sentry": {
            "command": "npx",
            "args": ["ts-node", "/Users/<your-user-directory>/sentry-mcp-ts/index.ts"],
            "env": {
                "SENTRY_AUTH": "<YOUR_AUTH_TOKEN>"
            }
        }
    }
}

• 在 args 字段中填写你的目录路径。
• 将 <YOUR_AUTH_TOKEN> 替换为你的 Sentry 身份验证令牌。

可用工具

list_projects

列出指定组织中所有可访问的 Sentry 项目。

参数：

• organization_slug（string，必填）：要列出项目所属组织的 slug
• view（string，可选）：视图类型，可以是 "summary" 或 "detailed"（默认值："detailed"）
• format（string，可选）：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

resolve_short_id

使用问题的短 ID 获取其详细信息。

参数：

• organization_slug（string，必填）：问题所属组织的 slug
• short_id（string，必填）：要解析的问题短 ID（例如，PROJECT-123）
• format（string，可选）：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

get_sentry_event

从某个问题中获取并分析特定的 Sentry 事件。

参数：

• issue_id_or_url（string，必填）：完整的 Sentry 问题 URL 或数字问题 ID
• event_id（string，必填）：要获取的特定事件 ID
• view（string，可选）：视图类型，可以是 "summary" 或 "detailed"（默认值："detailed"）
• format（string，可选）：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

list_error_events_in_project

列出指定 Sentry 项目中的错误事件。

参数：

• organization_slug（string，必填）：项目所属组织的 slug
• project_slug（string，必填）：要列出事件的项目 slug
• view（string，可选）：视图类型，可以是 "summary" 或 "detailed"（默认值："detailed"）
• format（string，可选）：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

create_project

在 Sentry 中创建新项目并获取其客户端密钥。

参数：

• organization_slug（string，必填）：要在其中创建项目的组织 slug
• team_slug（string，必填）：要将项目分配给的团队 slug
• name（string，必填）：新项目的名称
• platform（string，可选）：新项目的平台
• view（string，可选）：视图类型，可以是 "summary" 或 "detailed"（默认值："detailed"）
• format（string，可选）：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

list_project_issues

列出指定 Sentry 项目中的问题。

参数：

• organization_slug（string，必填）：项目所属组织的 slug
• project_slug（string，必填）：要列出问题的项目 slug
• view（string，可选）：视图类型，可以是 "summary" 或 "detailed"（默认值："detailed"）
• format（string，可选）：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

list_issue_events

列出特定 Sentry 问题的事件。

参数：

• organization_slug（string，必需）：问题所属组织的 slug
• issue_id（string，必需）：要列出事件的问题 ID
• view（string，可选）：视图类型，可选 "summary" 或 "detailed"（默认值："detailed"）
• format（string，可选）：输出格式，可选 "plain" 或 "markdown"（默认值："markdown"）

get_sentry_issue

检索并分析 Sentry 问题。

参数：

• issue_id_or_url（string，必需）：完整的 Sentry 问题 URL 或数字问题 ID
• view（string，可选）：视图类型，可选 "summary" 或 "detailed"（默认值："detailed"）
• format（string，可选）：输出格式，可选 "plain" 或 "markdown"（默认值："markdown"）

list_organization_replays

列出特定 Sentry 组织的回放。

参数：

• organization_slug（string，必需）：要列出回放的组织 slug
• project_ids（string[]，可选）：用于筛选回放的项目 ID 列表
• environment（string，可选）：用于筛选回放的环境
• stats_period（string，可选）：统计时间段（例如 "24h"、"7d"）
• start（string，可选）：筛选回放的开始日期
• end（string，可选）：筛选回放的结束日期
• sort（string，可选）：回放的排序字段
• query（string，可选）：用于筛选回放的搜索查询
• per_page（number，可选）：每页显示的回放数量
• cursor（string，可选）：分页游标
• view（string，可选）：视图类型，可选 "summary" 或 "detailed"（默认值："detailed"）
• format（string，可选）：输出格式，可选 "plain" 或 "markdown"（默认值："markdown"）

运行服务

npx ts-node index.ts

身份验证

此工具需要具备相应权限的 Sentry 身份验证令牌才能访问 Sentry API。你可以在 Sentry 账户设置中的 Settings -> User Settings -> Auth Tokens 下生成令牌。