Sentry问题管理服务器

Sentry MCP服务器是一个用于与Sentry API交互的工具,提供获取问题和事件详情的功能,适用于开发团队的错误追踪和管理。

  • by zereight
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 zereight/sentry-mcp

使用说明

哨兵MCP服务器

@zereight/哨兵服务器

哨兵MCP(模型上下文协议)服务器。允许与Sentry API交互以获取问题和事件详细信息。

用法

与Claude、Roo Code、Cline等一起使用。

将以下配置添加到MCP设置文件中(例如。, mcp_settings.json):

{
  "mcpServers": {
    "sentry-server-npm": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/sentry-server"
      ],
      "env": {
        "SENTRY_AUTH_TOKEN": "YOUR_SENTRY_AUTH_TOKEN", // Required
        "SENTRY_ORG_SLUG": "YOUR_ORG_SLUG",         // Required: Your Sentry organization slug
        "SENTRY_PROJECT_NAMES": "YOUR_PROJECT1,YOUR_PROJECT2", // Required: Comma-separated Sentry project slugs
        "SENTRY_BASE_URL": "YOUR_SENTRY_BASE_URL"   // Optional: Defaults to https://sentry.io
      },
      "disabled": false
    }
  }
}

替换占位符值,如 "YOUR_SENTRY_AUTH_TOKEN", "YOUR_ORG_SLUG",以及 "YOUR_PROJECT1,YOUR_PROJECT2" 与您的实际哨兵详细信息。提供以逗号分隔的项目段。Project slug用于Sentry URL(例如。, https://<org-slug>.sentry.io/settings/projects/<project-slug>/).可以在“用户设置”>“身份验证令牌”中生成身份验证令牌。

与Cursor(或直接CLI)一起使用

当与Cursor一起使用或直接运行时,您可以设置环境变量并按如下方式运行服务器:

env SENTRY_AUTH_TOKEN=YOUR_SENTRY_AUTH_TOKEN \
    SENTRY_ORG_SLUG=YOUR_ORG_SLUG \
    SENTRY_PROJECT_NAMES=YOUR_PROJECT1,YOUR_PROJECT2 \
    SENTRY_BASE_URL=YOUR_SENTRY_BASE_URL \
    npx @zereight/sentry-server
  • SENTRY_AUTH_TOKEN (必填):您的Sentry身份验证令牌。
  • SENTRY_ORG_SLUG (必填):你的哨兵组织的蛞蝓。
  • SENTRY_PROJECT_NAMES (必填):您的哨兵项目的逗号分隔名称(slugs)。
  • SENTRY_BASE_URL (可选):Sentry实例的基本URL(例如,用于自托管)。默认为 https://sentry.io.

工具🛠️

  1. get_sentry_issue

    • 获取特定哨兵问题的详细信息。 ℹ️
    • 输入:
      • issue_id_or_url (string,必填):哨兵问题ID或问题页面的完整URL。
    • 返回:有关问题的详细信息(JSON字符串)。
  2. list_organization_projects

    • 列出已配置的Sentry组织的所有项目。 📂
    • 输入:无
    • 返回:项目对象列表(JSON字符串)。
  3. list_project_issues

    • 列出特定项目的问题,并可进行筛选。🐛
    • 输入:
      • organization_slug (string,可选):组织的slug。默认为 SENTRY_ORG_SLUG env变种。
      • project_slug (string,必填):列出项目问题的slug。
      • query (字符串,可选):哨兵搜索查询以过滤问题(例如,“是:未解决的”,“受让人:我”)。
      • statsPeriod (字符串,可选):统计的时间段(例如,“24小时”、“14天”、“自动”)。
      • cursor (字符串,可选):用于获取下一页/上一页的分页光标。
    • 返回:问题对象和分页信息的列表(JSON字符串)。
  4. get_event_details

    • 获取项目中特定事件的详细信息。 📄
    • 输入:
      • organization_slug (string,可选):组织的slug。默认为 SENTRY_ORG_SLUG env变种。
      • project_slug (string,必填):事件所属项目的slug。
      • event_id (string,必填):要检索的事件的ID。
    • 返回:关于特定事件的详细信息(JSON字符串)。

环境变量配置

在运行服务器之前,您 必须 设置以下环境变量:

SENTRY_AUTH_TOKEN=YOUR_SENTRY_AUTH_TOKEN
SENTRY_ORG_SLUG=YOUR_ORG_SLUG
SENTRY_PROJECT_NAMES=YOUR_PROJECT_NAME1,YOUR_PROJECT_NAME2

您还可以选择设置:

SENTRY_BASE_URL=YOUR_SENTRY_BASE_URL # Default: https://sentry.io

检查器将提供一个URL,用于访问浏览器中的调试工具。

许可证

MIT许可证