Sentry MCP Server - AI驱动的错误追踪和调试

Posted on October 14, 2025

简介

Sentry MCP Server 是 Sentry 官方开发的 Model Context Protocol 服务器,旨在为编程 AI 助手(如 Claude Code、Cursor)提供强大的错误追踪和调试能力。该服务器作为 Sentry API 的中间件,使 LLM 能够直接访问和分析 Sentry 中的错误事件、堆栈跟踪、问题历史和性能数据,极大提升了开发者的调试效率。服务器支持两种部署模式:远程 MCP(推荐,由 Sentry 托管在 mcp.sentry.dev)和本地 stdio 模式。核心特性包括 AI 驱动的事件和问题搜索、OAuth 身份验证、支持自托管和 SaaS 两种 Sentry 部署方式。该项目基于 Cloudflare 的远程 MCP 概念,设计理念是 human-in-the-loop(人在回路中),确保 AI 助手在访问敏感数据时始终需要人工授权。

功能特性

AI 驱动的智能搜索 - 自然语言搜索错误和问题
完整错误上下文 - 访问堆栈跟踪和事件详情
双模式部署 - 支持 SaaS 和自托管 Sentry
OAuth 2.0 认证 - 安全的身份验证机制
远程 MCP - Sentry 官方托管(推荐)
本地 stdio 模式 - 本地开发和调试
MCP Inspector - 集成调试工具
Human-in-the-loop - 安全设计理念
多工具支持 - Cursor、Claude Code 等
性能监控 - 实时性能数据访问
项目管理 - 团队和项目功能
自动化分析 - AI 辅助错误诊断

支持的工具

search_events

AI 驱动的 Sentry 事件智能搜索。

参数:

query (string, 必需) - 搜索关键词或自然语言描述
project (string, 可选) - 项目 ID 或名称

使用示例:

用户: 帮我找找最近发生的所有数据库连接超时错误
AI 调用 search_events:
- query: "database connection timeout"
返回: 相关错误事件列表,包含时间、频率、影响范围

search_issues

AI 驱动的 Sentry 问题智能搜索。

参数:

query (string, 必需) - 搜索条件

get_event_details

获取特定错误事件的详细信息。

参数:

event_id (string, 必需) - 事件 ID

使用示例:

用户: 分析这个错误: abc123,告诉我可能的根本原因
AI 将:
1. 调用 get_event_details 获取完整堆栈跟踪
2. 分析错误类型和上下文
3. 提供修复建议

get_issue_details

获取问题的完整上下文和历史。

参数:

issue_id (string, 必需) - 问题 ID

list_projects

列出组织中的所有项目。

安装配置

方法1: 远程 MCP (推荐)

1
2
3

# 访问 Sentry 官方托管服务
# 无需本地安装
URL: https://mcp.sentry.dev

配置步骤:

访问 https://mcp.sentry.dev
使用 Sentry 账号进行 OAuth 授权
在客户端配置中添加远程端点

方法2: 本地开发 (stdio)

git clone https://github.com/getsentry/sentry-mcp.git
cd sentry-mcp
pnpm install
# 配置环境变量
export SENTRY_AUTH_TOKEN=your_token
pnpm dev

Claude Desktop 配置 (远程)

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev",
      "transport": "http",
      "auth": {
        "type": "oauth",
        "client_id": "your_client_id"
      }
    }
  }
}

Cursor 配置

{
  "mcp": {
    "servers": {
      "sentry": {
        "url": "https://mcp.sentry.dev",
        "transport": "http"
      }
    }
  }
}

本地 stdio 配置

{
  "mcpServers": {
    "sentry": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "SENTRY_AUTH_TOKEN": "your_token_here",
        "SENTRY_ORG": "your_org_slug"
      }
    }
  }
}

使用场景

1. 智能错误搜索

1 2	用户: 帮我找找最近发生的所有数据库连接超时错误 AI: 使用自然语言搜索,分析结果并提供摘要

2. 错误根因分析

用户: 分析这个错误的堆栈跟踪,告诉我可能的根本原因
AI:
- 获取完整事件详情
- 分析堆栈跟踪
- 识别问题模式
- 提供修复建议

3. 问题趋势分析

用户: 最近一周有哪些新出现的高频错误?
AI:
- 搜索指定时间范围的问题
- 分析频率和趋势
- 识别新出现的模式

4. 性能问题诊断

用户: 帮我找出导致 API 响应慢的原因
AI:
- 搜索性能相关事件
- 分析慢查询
- 定位瓶颈点

适用场景

AI 辅助错误调试和根因分析
自动化问题分类和优先级排序
智能错误模式识别
加速问题修复流程
性能瓶颈诊断
错误趋势分析和预警
开发者工作流程优化
团队协作和知识共享
生产环境问题快速响应
错误文档自动生成

OAuth 配置

需要的权限范围:

org:read - 读取组织信息
project:read - 读取项目数据
project:write - 写入项目数据
team:read - 读取团队信息
team:write - 写入团队数据
event:write - 写入事件数据

配置指南: https://docs.sentry.io/product/sentry-mcp/

项目信息

作者/组织: Sentry
协议: Apache-2.0
语言: TypeScript
依赖: @modelcontextprotocol/sdk, Sentry SDK, OAuth 客户端库
Node.js: >= 18
包管理器: pnpm

官方服务器 🌟

Sentry 官方维护的 MCP 服务器

2025年重大发布 🚀

2025年8月14日正式发布 MCP Server Monitoring 功能

评分: 4.6/5.0

功能性: 4.8
文档质量: 4.5
活跃度: 4.5
受欢迎程度: 4.3
代码质量: 4.8

特别说明:

基于 Cloudflare 的远程 MCP 架构
推荐使用远程模式(由 Sentry 官方托管)
Human-in-the-loop 设计确保数据安全
支持自托管和 SaaS 两种 Sentry 部署

相关链接:

生产环境: https://mcp.sentry.dev
文档: https://docs.sentry.io/product/sentry-mcp/
博客: Monitoring MCP Server

GitHub: getsentry/sentry-mcp