什麼是 Sentry 自託管 MCP 服務器？

這是一個專門為與自託管 Sentry 實例交互設計的工具。它允許您查看和更新 Sentry 中的問題狀態、添加註釋、列出項目和事件等。

如何使用 Sentry 自託管 MCP 服務器？

首先，您需要設置環境變量並運行服務器。然後，通過客戶端連接到服務器，使用命令來執行具體操作。

適用場景

適用於希望集中管理和監控 Sentry 問題的企業用戶，特別是需要頻繁更新問題狀態或批量處理事件的團隊。

主要功能

獲取 Sentry 問題詳情通過問題 ID 或 URL 獲取 Sentry 問題的具體信息。

列出 Sentry 項目列出當前 Sentry 組織中的所有項目。

列出 Sentry 問題根據指定的項目和條件篩選問題列表。

獲取 Sentry 事件詳情通過項目和事件 ID 查看具體事件的詳細信息。

更新 Sentry 問題狀態將問題的狀態更改為已解決、忽略或未解決。

為 Sentry 問題添加註釋在 Sentry 問題中添加新的註釋。

優勢與侷限性

優勢

與自託管 Sentry 集成，無需依賴第三方服務。

支持多種操作，滿足日常管理需求。

易於集成到現有工作流中。

侷限性

需要手動設置環境變量。

可能需要一定的技術背景來配置和運行服務器。

如何使用

安裝與配置

克隆項目代碼，安裝依賴並編譯服務器。

配置環境變量

設置 SENTRY_URL、SENTRY_AUTH_TOKEN 和 SENTRY_ORG_SLUG。

啟動服務器

運行服務器以開始與 Sentry 交互。

使用案例

獲取問題詳情通過問題 ID 獲取 Sentry 問題的詳細信息。

更新問題狀態將某個問題的狀態更改為已解決。

常見問題

如何確保我的 Sentry 數據安全？

如果遇到服務器無法啟動怎麼辦？

🚀 自託管 Sentry 的 MCP 服務器

這是一個專為與自託管 Sentry 實例交互而設計的模型上下文協議 (MCP) 服務器，它提供了一系列工具，可用於檢索自託管 Sentry 環境中的信息並執行相關操作。

🚀 快速開始

此服務器提供了檢索信息和執行操作的工具，用於自託管 Sentry 環境中的問題。它從環境變量中讀取 Sentry 實例 URL、認證令牌和組織標識符（slug）。

✨ 主要特性

提供多種工具，可檢索特定 Sentry 問題詳細信息、列出項目和問題、獲取事件詳情、更新問題狀態以及添加評論。
支持從環境變量中讀取配置信息，方便靈活部署。

📦 安裝指南

克隆/放置項目：克隆此倉庫或將其項目文件放在您選擇的位置。
安裝依賴項：進入項目目錄 (sentry-selfhosted-mcp) 並運行：
```
cd <path/to/sentry-selfhosted-mcp>
npm install
```
構建服務器：從項目目錄編譯 TypeScript 代碼：
```
npm run build
```
這將在 build/ 目錄中創建可執行的 JavaScript 文件。

📚 詳細文檔

已提供的工具

以下工具可供使用：

get_sentry_issue
- 描述：通過 ID 或 URL 檢索特定 Sentry 問題的詳細信息。
- 輸入：{ "issue_id_or_url": "string" }（例如，"12345" 或 "https://sentry.example.com/organizations/org/issues/12345/"）
list_sentry_projects
- 描述：列出配置的 Sentry 組織中的所有項目。
- 輸入：{}（無需參數）
list_sentry_issues
- 描述：按項目列出問題，可選過濾查詢或狀態。
- 輸入：{ "project_slug": "string", "query": "string" (可選), "status": "resolved" | "unresolved" | "ignored" (可選) }
get_sentry_event_details
- 描述：檢索項目中特定事件 ID 的詳細信息。
- 輸入：{ "project_slug": "string", "event_id": "string" }
update_sentry_issue_status
- 描述：更新 Sentry 問題的狀態。
- 輸入：{ "issue_id": "string", "status": "resolved" | "ignored" | "unresolved" }
create_sentry_issue_comment
- 描述：在 Sentry 問題上添加評論。
- 輸入：{ "issue_id": "string", "comment_text": "string" }

配置

此服務器需要以下環境變量：

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 組織的標識符（例如，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"
      }
    }