Sentry MCP Server

Sentry MCP Server

site icon
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)。

工具列表

  1. inspect_sentry:检查服务器配置和连接状态。
  2. list_recent_releases:列出最近的发布版本及其新问题数量。
  3. get_releases:获取项目的所有发布版本。
  4. get_release_health:获取特定发布版本的健康统计数据。
  5. get_issue:获取特定 Sentry 问题的详细信息。
  6. get_release_issues:获取与特定发布版本关联的所有问题。

常见问题解答

  • 如何配置 Sentry 认证令牌?:在 .env 文件中设置 SENTRY_AUTH_TOKEN
  • 如何连接自托管的 Sentry 实例?:在 .env 文件中设置 SENTRY_BASE_URL 为自托管实例的 API 端点。
  • 如何验证服务器配置?:使用 inspect_sentry 工具检查配置和连接状态。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 克隆仓库: bash git clone https://github.com/srcgrp/sentry-mcp-server.git cd sentry-mcp-server

安装教程

  1. 安装依赖并构建服务器: bash npm install npm run build
  2. 配置 MCP 客户端:
  3. 在 MCP 客户端的配置文件中添加服务器路径(如 cline_mcp_settings.json)。
  4. 使用绝对路径指向 build/index.js
  5. 创建 .env 文件并设置 Sentry 认证信息: dotenv SENTRY_AUTH_TOKEN="YOUR_SENTRY_AUTH_TOKEN" SENTRY_BASE_URL="https://sentry.io/api/0/" SENTRY_ORG_SLUG="your-organization-slug"

调试方式

  1. 使用 inspect_sentry 工具验证配置: json { "tool_name": "inspect_sentry", "arguments": {} }
  2. 检查输出中的配置和连接状态。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。