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 以了解如何参与。