mcp-sentry: A Sentry MCP Server

mcp-sentry：Sentry MCP 服务

用于从 Sentry.io 检索和分析问题的 Model Context Protocol 服务。此服务提供工具，可检查 Sentry 账户中的错误报告、堆栈跟踪和其他调试信息。

概述

此 MCP 服务允许 AI 助手访问和分析 Sentry 问题，获取应用中错误的详细信息。

工具

1. get_sentry_issue

   按 ID 或 URL 检索并分析 Sentry 问题

   输入：

   • issue_id_or_url（字符串）：要分析的 Sentry 问题 ID 或 URL

   返回： 问题详情，包括：

   • 标题
   • 问题 ID
   • 状态
   • 级别
   • 首次出现时间戳
   • 最近出现时间戳
   • 事件计数
   • 完整堆栈跟踪

提示词

1. sentry-issue

   从 Sentry 检索问题详情

   输入：

   • issue_id_or_url（字符串）：Sentry 问题 ID 或 URL

   返回： 格式化的问题详情，作为对话上下文

安装

前置条件

• Node.js 14 或更高版本
• 拥有身份验证令牌的 Sentry 账户

使用 npm

npm install -g mcp-sentry

安装后，你可以将其作为命令运行：

mcp-sentry --auth-token YOUR_SENTRY_TOKEN

或使用环境变量：

SENTRY_TOKEN=YOUR_SENTRY_TOKEN mcp-sentry

使用 npx（无需安装）

npx mcp-sentry --auth-token YOUR_SENTRY_TOKEN

开发

项目结构

mcp-sentry/
├── src/
│   ├── index.ts           # Main entry point
│   ├── server.ts          # MCP server implementation
│   ├── sentry-client.ts   # Sentry API client
│   ├── models.ts          # Data models
│   ├── utils.ts           # Utility functions
│   └── types/             # Type definitions
├── build/                 # Compiled JavaScript files (included in the repository for direct npx execution)
├── package.json
├── tsconfig.json
└── README.md

构建

npm run build

注意：与典型的 Node.js 项目不同，此仓库会提交构建目录，以支持直接使用 npx 执行，而无需用户自行构建项目。

在开发模式下运行

npm run dev -- --auth-token YOUR_SENTRY_TOKEN

身份验证

此服务需要 Sentry 身份验证令牌才能访问 Sentry API。你可以通过以下两种方式提供此令牌：

1. 使用 --auth-token 命令行选项：

   mcp-sentry --auth-token YOUR_SENTRY_TOKEN
   

2. 使用 SENTRY_TOKEN 环境变量：

   SENTRY_TOKEN=YOUR_SENTRY_TOKEN mcp-sentry
   

与 Claude Desktop 搭配使用

将以下内容添加到 Claude Desktop 配置中：

"mcpServers": {
  "sentry": {
    "command": "mcp-sentry",
    "args": ["--auth-token", "YOUR_SENTRY_TOKEN"]
  }
}

与 Zed 搭配使用

添加到 Zed 的 settings.json 中：

"context_servers": [
  "mcp-server-sentry": {
    "command": {
      "path": "mcp-sentry",
      "args": ["--auth-token", "YOUR_SENTRY_TOKEN"]
    }
  }
],

调试

你可以使用 MCP inspector 调试此服务：

npx @modelcontextprotocol/inspector mcp-sentry --auth-token YOUR_SENTRY_TOKEN

许可证

此 MCP 服务采用 MIT 许可证。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。