
Sentry MCP Server

2025.04.12
1
JavaScript错误追踪开发工具开发效率
Sentry MCP Server 是一个集成 Sentry 错误追踪功能的 Model Context Protocol (MCP) 服务器,旨在帮助开发者直接在 MCP 支持的环境(如 VS Code 的 Cline 扩展)中访问 Sentry 的发布健康数据和问题详情,从而提升应用程序的稳定性监控和问题排查效率。
View on GitHub
Overview
基本能力
产品定位
Sentry MCP Server 是一个专为开发者设计的工具,用于在开发环境中直接集成 Sentry 的错误追踪和发布监控功能,提升开发效率和问题排查能力。
核心功能
- 发布监控:列出最近的发布版本及其关联的新问题数量。
- 发布健康:获取特定发布版本的详细统计数据,包括崩溃率和会话数。
- 问题调查:通过问题 ID 获取 Sentry 问题的详细信息。
- 定向问题列表:检索与特定发布版本关联的所有问题。
- 灵活连接:支持 Sentry.io(云端)和自托管的 Sentry 实例。
- 服务器检查:提供工具用于验证配置和服务器状态。
适用场景
- 开发者在开发过程中需要实时监控应用程序的稳定性。
- 团队需要快速排查和修复生产环境中的问题。
- 需要集成 Sentry 功能到 MCP 支持的环境中(如 VS Code)。
工具列表
- inspect_sentry:检查服务器配置和连接状态。
- list_recent_releases:列出最近的发布版本及其新问题数量。
- get_releases:获取项目的所有发布版本。
- get_release_health:获取特定发布版本的健康统计数据。
- get_issue:获取特定 Sentry 问题的详细信息。
- get_release_issues:获取与特定发布版本关联的所有问题。
常见问题解答
- 如何配置 Sentry 认证令牌?:在
.env
文件中设置SENTRY_AUTH_TOKEN
。 - 如何连接自托管的 Sentry 实例?:在
.env
文件中设置SENTRY_BASE_URL
为自托管实例的 API 端点。 - 如何验证服务器配置?:使用
inspect_sentry
工具检查配置和连接状态。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 克隆仓库:
bash git clone https://github.com/srcgrp/sentry-mcp-server.git cd sentry-mcp-server
安装教程
- 安装依赖并构建服务器:
bash npm install npm run build
- 配置 MCP 客户端:
- 在 MCP 客户端的配置文件中添加服务器路径(如
cline_mcp_settings.json
)。 - 使用绝对路径指向
build/index.js
。 - 创建
.env
文件并设置 Sentry 认证信息:dotenv SENTRY_AUTH_TOKEN="YOUR_SENTRY_AUTH_TOKEN" SENTRY_BASE_URL="https://sentry.io/api/0/" SENTRY_ORG_SLUG="your-organization-slug"
调试方式
- 使用
inspect_sentry
工具验证配置:json { "tool_name": "inspect_sentry", "arguments": {} }
- 检查输出中的配置和连接状态。