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/")

1. list_sentry_projects

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

1. list_sentry_issues

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

1. get_sentry_event_details

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

1. update_sentry_issue_status

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

1. create_sentry_issue_comment

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

安装和设置

1. 克隆/放置项目： 克隆此存储库或将项目文件放置在所需的位置。
2. 安装依赖关系： 导航到项目目录(sentry-selfhosted-mcp)并运行：

   cd 

   npm install

1. 构建服务器： 从项目目录编译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": [
        ""
      ],
      "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客户端应自动连接到服务器。