Sentry MCP Server

Sentry MCP 服务器

一个用于与 Sentry 交互的模型上下文协议 (MCP) 服务器。此 MCP 服务器提供与 Sentry API 交互的工具，允许 AI 助手检索和分析错误数据、管理项目以及监控应用程序性能。

要求

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

设置

1. 安装依赖项:

   npm install
   

在 IDE 中使用

此 MCP 已验证可与 Codeium Windsurf 配合使用。

Cursor 目前的 MCP 实现存在问题；此工具尚未完全正常运行。

与 Claude 一起使用

要将此 MCP 服务器与 Claude 一起使用，请将以下配置添加到您的 Claude 设置：

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

• 使用您的目录路径更新 args 字段。
• 将 <YOUR_AUTH_TOKEN> 替换为您的 Sentry 身份验证令牌。

可用工具

list_projects

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

参数：

• organization_slug (字符串，必需)：要从中列出项目的组织的 slug
• view (字符串，可选)：视图类型，可以是 "summary" 或 "detailed"（默认值："detailed"）
• format (字符串，可选)：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

resolve_short_id

使用问题的短 ID 检索有关问题的详细信息。

参数：

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

get_sentry_event

从问题中检索和分析特定的 Sentry 事件。

参数：

• issue_id_or_url (字符串，必需)：完整的 Sentry 问题 URL 或仅是数字问题 ID
• event_id (字符串，必需)：要检索的特定事件 ID
• view (字符串，可选)：视图类型，可以是 "summary" 或 "detailed"（默认值："detailed"）
• format (字符串，可选)：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

list_error_events_in_project

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

参数：

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

create_project

在 Sentry 中创建一个新项目并检索其客户端密钥。

参数：

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

list_project_issues

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

参数：

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

list_issue_events

列出特定 Sentry 问题的事件。

参数：

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

get_sentry_issue

检索和分析 Sentry 问题。

参数：

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

list_organization_replays

列出特定 Sentry 组织的重放。

参数：

• organization_slug (字符串，必需)：要从中列出重放的组织的 slug
• project_ids (字符串数组，可选)：用于过滤重放的项目 ID 列表
• environment (字符串，可选)：用于过滤重放的环境
• stats_period (字符串，可选)：统计信息的时间段（例如，“24h”，“7d”）
• start (字符串，可选)：用于过滤重放的开始日期
• end (字符串，可选)：用于过滤重放的结束日期
• sort (字符串，可选)：用于对重放进行排序的字段
• query (字符串，可选)：用于过滤重放的搜索查询
• per_page (数字，可选)：每页的重放次数
• cursor (字符串，可选)：用于分页的光标
• view (字符串，可选)：视图类型，可以是 "summary" 或 "detailed"（默认值："detailed"）
• format (字符串，可选)：输出格式，可以是 "plain" 或 "markdown"（默认值："markdown"）

运行服务器

npx ts-node index.ts

身份验证

此工具需要具有适当权限的 Sentry 身份验证令牌才能访问 Sentry API。 您可以在 Sentry 帐户设置中的“API 密钥”下生成令牌。

错误处理

该服务器包括全面的错误处理，用于处理：

• 缺少身份验证令牌
• API 请求失败
• 无效参数
• 网络错误

所有错误都会记录到控制台以进行调试。