AI导哈

Sentry MCP服务器

一个快速、轻量级的MCP服务器，用于与Sentry的API交互，提供问题详情、追踪详情和事件搜索功能。

  • by utapyngo
  • Rust
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 utapyngo/sentry-mcp-rs

使用说明

哨兵mcp

快速、轻便 主控程序 Sentry的服务器，用Rust编写。

为什么是mcp哨兵？

与 官方Node.js服务器:

  • 内存： RAM使用量减少10倍
  • 启动： 瞬时冷启动
  • 磁盘： 单一二进制文件，无运行时依赖关系
  • 代币： 更少的工具=上下文中的工具列表更小

特性

此MCP服务器提供与Sentry的API交互的工具：

  • 获取问题详细信息 -检索有关哨兵问题的详细信息，包括元数据、标签、堆栈跟踪，以及可选的特定事件
  • get_trace_details -检索跟踪详细信息，包括跨度树和时间信息，以进行分布式跟踪分析
  • 搜索问题事件 -使用Sentry的查询语法搜索问题中的事件

安装

来自crates.io：

cargo install sentry-mcp

来自GitHub：

cargo install --git https://github.com/utapyngo/sentry-mcp-rs.git

或与 布置:

mise use -g github:utapyngo/sentry-mcp-rs

二进制文件将按以下方式安装 sentry-mcp.

配置

所需的环境变量：

  • SENTRY_AUTH_TOKEN -您的Sentry API身份验证令牌
  • SENTRY_HOST -您的Sentry实例主机名（例如。， sentry.io)

可选：

  • SOCKS_PROXY -SOCKS5代理URL（例如。， socks5://127.0.0.1:1080)
  • HTTPS_PROXY -HTTPS代理URL

MCP客户端配置

添加到MCP客户端配置中：

{
  "mcpServers": {
    "sentry": {
      "command": "sentry-mcp",
      "env": {
        "SENTRY_AUTH_TOKEN": "your_token_here",
        "SENTRY_HOST": "sentry.io"
      }
    }
  }
}

或者不使用mise进行安装：

{
  "mcpServers": {
    "sentry": {
      "command": "mise",
      "args": ["x", "github:utapyngo/sentry-mcp-rs", "--", "sentry-mcp"],
      "env": {
        "SENTRY_AUTH_TOKEN": "your_token_here",
        "SENTRY_HOST": "sentry.io"
      }
    }
  }
}

发展

克隆存储库并创建 .env 文件：

git clone https://github.com/utapyngo/sentry-mcp-rs.git
cd sentry-mcp-rs
cp .env.example .env
# Edit .env with your credentials

与MCP检查员一起构建和测试：

cargo build --release
npx @modelcontextprotocol/inspector ./run.sh

或者配置MCP客户端以使用该脚本：

{
  "mcpServers": {
    "sentry": {
      "command": "/path/to/sentry-mcp-rs/run.sh"
    }
  }
}

工具

获取问题详细信息

检索有关特定哨兵问题的详细信息。

参数：

  • issue_url -完整的哨兵问题URL（以下参数的替代方案）
  • organization_slug -组织块（如果需要，则需要 issue_url 未提供）
  • issue_id -问题ID类似 PROJECT-123 或数字ID（如果需要 issue_url 未提供）
  • event_id -要获取的特定事件ID，而不是最新的（可选）

get_trace_details

检索分布式跟踪分析的跟踪详细信息。

参数：

  • organization_slug -组织结构图
  • trace_id -32个字符的十六进制跟踪ID

搜索问题事件

使用Sentry的查询语法搜索问题中的事件。

参数：

  • organization_slug -组织结构图
  • issue_id -问题ID（例如。， PROJECT-123)
  • query -可选哨兵搜索查询
  • limit -要返回的最大事件数（默认值：10，最大值：100）
  • sort -排序顺序： newest （默认）或 oldest

相关 MCP