AI导哈

Sentry自托管交互协议

一个专为自托管Sentry实例设计的交互协议服务器，提供问题检索、状态更新和评论功能。

  • by ddfourtwo
  • JavaScript
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 ddfourtwo/sentry-selfhosted-mcp

使用说明

哨兵自助式mcp

一种模型上下文协议（MCP）服务器，专为与自托管哨兵实例交互而设计。

概述

此服务器提供工具来检索信息，并对自托管Sentry设置中的问题执行操作。它从环境变量中读取Sentry实例URL、身份验证令牌和组织块。

可用工具

以下工具可用：

  1. get_sentry_issue

    • 描述：通过ID或URL检索特定哨兵问题的详细信息。
    • 输入： { "issue_id_or_url": "string" } （例如，“12345”或“https://sentry.example.com/organizations/org/issues/12345/")

  2. list_sentry_projects

    • 描述：列出配置的哨兵组织内的所有项目。
    • 输入： {} （无需争论）

  3. list_sentry_issues

    • 描述：列出特定项目的问题，可选择按查询或状态进行筛选。
    • 输入： { "project_slug": "string", "query": "string" (optional), "status": "resolved" | "unresolved" | "ignored" (optional) }

  4. get_sentry_event_details

    • 描述：检索项目中特定事件ID的详细信息。
    • 输入： { "project_slug": "string", "event_id": "string" }

  5. update_sentry_issue_status

    • 描述：更新哨兵问题的状态。
    • 输入： { "issue_id": "string", "status": "resolved" | "ignored" | "unresolved" }

  6. create_sentry_issue_comment

    • 描述：为Sentry问题添加评论。
    • 输入： { "issue_id": "string", "comment_text": "string" }

安装和设置

  1. 克隆/放置项目： 克隆此存储库或将项目文件放置在所需的位置。
  2. 安装依赖关系： 导航到项目目录(sentry-selfhosted-mcp)并运行：
    cd <path/to/sentry-selfhosted-mcp>
npm install
  3. 构建服务器： 从项目目录编译TypeScript代码：
    npm run build
    这将在 build/ 目录。

配置

此服务器需要设置以下环境变量：

  • SENTRY_URL：您自托管Sentry实例的基本URL（例如。， https://sentry.beoflow.app).
  • SENTRY_AUTH_TOKEN：您的Sentry API身份验证令牌（确保它具有必要的作用域，如 issue:read, project:read, event:read, issue:write, comment:write).
  • SENTRY_ORG_SLUG：你的哨兵组织的蛞蝓（例如。， beoflow).

MCP客户端配置示例：

将以下条目添加到MCP客户端的配置文件中（例如。， cline_mcp_settings.json 对于VS代码扩展， claude_desktop_config.json 对于Claude.app）：

    "sentry-selfhosted-mcp": {
      "command": "node",
      "args": [
        "<full/path/to/sentry-selfhosted-mcp/build/index.js>"
      ],
      "env": {
        "SENTRY_URL": "YOUR_SENTRY_URL",
        "SENTRY_AUTH_TOKEN": "YOUR_SENTRY_AUTH_TOKEN",
        "SENTRY_ORG_SLUG": "YOUR_SENTRY_ORG_SLUG"
      },
      "disabled": false,
      "autoApprove": [],
      "transportType": "stdio"
    }

替换 YOUR_SENTRY_URL, YOUR_SENTRY_AUTH_TOKEN，以及 YOUR_SENTRY_ORG_SLUG 与你的实际价值观。

更新设置文件后，MCP客户端应自动连接到服务器。

相关 MCP