mcp-sentry: 一个 Sentry MCP 服务器

概述

这是一个用于从 Sentry.io 获取和分析问题的 Model Context Protocol 服务器。该服务器提供了工具来检查来自您的 Sentry 账户的错误报告、堆栈跟踪和其他调试信息。

工具

1. get_sentry_issue
   • 通过 ID 或 URL 检索并分析 Sentry 问题
   • 输入:
     • issue_id_or_url (字符串): 需要分析的 Sentry 问题 ID 或 URL
   • 返回: 问题详情，包括:
     • 标题
     • 问题 ID
     • 状态
     • 级别
     • 首次出现时间戳
     • 最后一次出现时间戳
     • 事件计数
     • 完整堆栈跟踪
2. get_list_issues
   • 通过项目 slug 检索并分析 Sentry 问题
   • 输入:
     • project_slug (字符串): 需要分析的 Sentry 项目 slug
     • organization_slug (字符串): 需要分析的 Sentry 组织 slug
   • 返回: 问题列表，包括以下细节:
     • 标题
     • 问题 ID
     • 状态
     • 级别
     • 首次出现时间戳
     • 最后一次出现时间戳
     • 事件计数
     • 基本问题信息

提示

1. sentry-issue
   • 从 Sentry 获取问题详情
   • 输入:
     • issue_id_or_url (字符串): Sentry 问题 ID 或 URL
   • 返回: 作为对话上下文格式化的问题详情

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 mcp-sentry:

npx -y @smithery/cli install @qianniuspace/mcp-sentry --client claude

使用 uv（推荐）

当使用 uv 时，不需要特定的安装步骤。我们将使用 uvx 直接运行 mcp-sentry。

使用 PIP

或者，您也可以通过 pip 安装 mcp-sentry：

pip install mcp-sentry

或使用 uv

uv pip install -e .

安装后，您可以使用以下命令作为脚本运行它：

python -m mcp_sentry

配置

与 Claude Desktop 一起使用

将此添加到您的 claude_desktop_config.json 文件中：

"mcpServers": {
  "sentry": {
    "command": "uvx",
    "args": ["mcp-sentry", "--auth-token", "YOUR_SENTRY_TOKEN","--project-slug" ,"YOUR_PROJECT_SLUG", "--organization-slug","YOUR_ORGANIZATION_SLUG"]
  }
}

"mcpServers": {
  "sentry": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "mcp/sentry", "--auth-token", "YOUR_SENTRY_TOKEN","--project-slug" ,"YOUR_PROJECT_SLUG", "--organization-slug","YOUR_ORGANIZATION_SLUG"]
  }
}

"mcpServers": {
  "sentry": {
    "command": "python",
    "args": ["-m", "mcp_sentry", "--auth-token", "YOUR_SENTRY_TOKEN","--project-slug" ,"YOUR_PROJECT_SLUG", "--organization-slug","YOUR_ORGANIZATION_SLUG"]
  }
}

与 Zed 一起使用

将此添加到您的 Zed settings.json 文件中：

例如 Cursor

"context_servers": [
  "mcp-sentry": {
    "command": {
      "path": "uvx",
      "args": ["mcp-sentry", "--auth-token", "YOUR_SENTRY_TOKEN","--project-slug" ,"YOUR_PROJECT_SLUG", "--organization-slug","YOUR_ORGANIZATION_SLUG"]
    }
  }
],

"context_servers": {
  "mcp-sentry": {
    "command": "python",
    "args": ["-m", "mcp_sentry", "--auth-token", "YOUR_SENTRY_TOKEN","--project-slug" ,"YOUR_PROJECT_SLUG", "--organization-slug","YOUR_ORGANIZATION_SLUG"]
  }
},

"context_servers": {
  "sentry": {
      "command": "python",
      "args": [
        "-m",
        "mcp_sentry",
        "--auth-token",
        "YOUR_SENTRY_TOKEN",
        "--project-slug",
        "YOUR_PROJECT_SLUG",
        "--organization-slug",
        "YOUR_ORGANIZATION_SLUG"
      ],
      "env": {
        "PYTHONPATH": "path/to/mcp-sentry/src"
      }
    }
},

调试

您可以使用 MCP 检查器来调试服务器。对于 uvx 安装：

npx @modelcontextprotocol/inspector uvx mcp-sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG

或者如果您已将包安装在特定目录中或正在开发中：

cd path/to/servers/src/sentry
npx @modelcontextprotocol/inspector uv run mcp-sentry --auth-token YOUR_SENTRY_TOKEN --project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG  

或在终端中

npx @modelcontextprotocol/inspector uv --directory /Volumes/ExtremeSSD/MCP/mcp-sentry/src run mcp_sentry --auth-token YOUR_SENTRY_TOKEN
--project-slug YOUR_PROJECT_SLUG --organization-slug YOUR_ORGANIZATION_SLUG

分支来源

• https://github.com/modelcontextprotocol/servers/tree/main/src/sentr

许可证

此MCP服务器根据MIT许可证授权。这意味着您可以自由使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。有关更多详细信息，请参阅项目仓库中的LICENSE文件。