sentry-selfhosted-mcp

一个专门为与自托管的Sentry实例交互设计的Model Context Protocol (MCP)服务器。

概述

此服务器提供了工具，用于获取信息并在自托管的Sentry设置中的问题上执行操作。它从环境变量中读取Sentry实例URL、认证令牌和组织slug。

可用工具

以下工具可用：

1. get_sentry_issue

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

2. list_sentry_projects

   • 描述：列出配置的Sentry组织内的所有项目。
   • 输入：{} （无需参数）

3. list_sentry_issues

   • 描述：列出特定项目的issues，可选地按查询或状态过滤。
   • 输入：{ "project_slug": "string", "query": "string" (可选), "status": "resolved" | "unresolved" | "ignored" (可选) }

4. get_sentry_event_details

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

5. update_sentry_issue_status

   • 描述：更新Sentry问题的状态。
   • 输入：{ "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/目录中创建可执行的JavaScript文件。

配置

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

• 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：您的Sentry组织的slug（例如：beoflow）。

示例MCP客户端配置：

在您的MCP客户端配置文件中添加以下条目（例如，VS Code扩展的cline_mcp_settings.json，Claude.app的claude_desktop_config.json）：

    "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客户端应自动连接到服务器。