MCP Sentry: A Sentry MCP Server

🚀 mcp - sentry：一個 Sentry MCP 服務器

mcp - sentry 是一個模型上下文協議 (MCP) 服務器，用於從 Sentry.io 獲取並分析問題。它提供了一系列工具，可幫助您檢查應用程序中的錯誤報告、堆棧跟蹤和其他調試信息，為問題排查和解決提供有力支持。

🚀 快速開始

此 MCP 服務器允許 AI 助手訪問並分析 Sentry 問題，提供詳細的問題信息。

✨ 主要特性

工具

1. get_sentry_issue 根據 ID 或 URL 獲取和分析一個 Sentry 問題。

   • 輸入：
     • issue_id_or_url (字符串)：Sentry 問題 ID 或 URL
   • 返回：包括以下詳細信息的問題詳情：
     • 標題
     • 問題 ID
     • 狀態
     • 級別
     • 首次出現時間戳
     • 最近出現時間戳
     • 事件計數
     • 完整堆棧跟蹤

2. sentry - issue 從 Sentry 獲取問題詳情。

   • 輸入：
     • issue_id_or_url (字符串)：Sentry 問題 ID 或 URL
   • 返回：格式化的問題詳細信息，作為對話上下文

📦 安裝指南

先決條件

• Node.js 14 或更高版本
• 帶有認證令牌的 Sentry 賬戶

使用 npm

npm install -g mcp-sentry

安裝完成後，可以按如下方式運行：

mcp-sentry --auth-token 您的_SENTRY_TOKEN

或通過環境變量：

SENTRY_TOKEN=您的_SENTRY_TOKEN mcp-sentry

使用 npx（無需安裝）

npx mcp-sentry --auth-token 您的_SENTRY_TOKEN

💻 使用示例

與 Claude Desktop 結合使用

將此內容添加到您的 Claude Desktop 配置中：

"mcpServers": {
  "sentry": {
    "command": "mcp-sentry",
    "args": ["--auth-token", "您的_SENTRY_TOKEN"]
  }
}

與 VS Code 結合使用

在 VS Code 中，您可以配置任務以支持此服務器。例如：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "啟動 Sentry MCP 服務器",
      "type": "shell",
      "command": "npx mcp-sentry --auth-token ${env:SENTRY_TOKEN}",
      "args": []
    }
  ]
}

📚 詳細文檔

開發

項目結構

mcp-sentry/
├── src/
│   ├── index.ts           # 入口文件
│   ├── server.ts          # MCP 服務器實現
│   ├── sentry-client.ts   # Sentry API 客戶端
│   ├── models.ts          # 數據模型
│   ├── utils.ts           # 工具函數
│   └── types/             # 類型定義
├── build/                 # 編譯後的 JavaScript 文件（包含在倉庫中以支持直接使用 npx）
├── package.json
├── tsconfig.json
└── README.md

構建

npm run build

注意：與典型的 Node.js 項目不同，構建目錄已提交到此倉庫，以便支持直接使用 npx 執行而不必讓用戶自行構建。

開發模式下運行

npm run dev -- --auth-token 您的_SENTRY_TOKEN

認證

此服務器需要一個 Sentry 認證令牌以訪問 Sentry API。您可以通過以下兩種方式提供該令牌：

1. 使用 --auth-token 命令行選項：

mcp-sentry --auth-token 您的_SENTRY_TOKEN

2. 使用環境變量 SENTRY_TOKEN：

SENTRY_TOKEN=您的_SENTRY_TOKEN mcp-sentry

📄 許可證

[這裡填寫許可證信息]

📞 聯繫方式

• GitHub: 項目倉庫
• 郵箱: your.email@example.com

👋 項目貢獻

歡迎為該項目做出貢獻！請參考 CONTRIBUTING.md 以瞭解如何參與。