mcp-sentry：一个 Sentry MCP 服务器

这是一个用于从 Sentry.io 获取和分析问题的模型上下文协议 (MCP) 服务器。该服务器提供了工具来检查应用程序中的错误报告、堆栈跟踪和其他调试信息。

概述

此 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

开发

项目结构

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
   

与 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": []
    }
  ]
}

项目贡献

欢迎为该项目做出贡献！请参考 CONTRIBUTING.md 以了解如何参与。

许可证

[这里填写许可证信息]

联系方式

• GitHub: 项目仓库
• 邮箱: your.email@example.com