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>/sentry-mcp-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 API的Sentry认证令牌。您可以在Sentry帐户设置下的"API Keys"中生成令牌。

错误处理

服务器包括全面的错误处理，涵盖以下情况：

• 缺失认证令牌
• API 请求失败
• 无效参数
• 网络错误

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