关于 sentry-selfhosted-mcp
sentry-selfhosted-mcp 将 MCP 客户端连接到自托管的 Sentry 实例,支持查询问题与事件、列出项目、更新问题状态和添加评论。
主要功能
- 01按 ID 或 URL 获取问题详情
- 02列出组织中的项目
- 03按项目、查询条件或状态筛选问题
- 04获取事件详情
- 05更改问题状态并添加评论
适用场景
- 01检查自托管 Sentry 实例中的问题
- 02按状态或查询条件查看项目问题
- 03解决或忽略问题并添加评论
MCP 相关
提供查询项目、问题和事件,以及更新问题状态或评论的工具。通过环境变量读取 Sentry URL、认证令牌和组织标识。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
sentry-selfhosted-mcp
专为与自托管 Sentry 实例交互而设计的模型上下文协议(MCP)服务。
概述
此服务提供工具,用于在自托管 Sentry 环境中检索信息并对问题执行操作。它从环境变量中读取 Sentry 实例 URL、身份验证令牌和组织 slug。
可用工具
以下工具可用:
-
get_sentry_issue- 说明:通过 ID 或 URL 检索特定 Sentry 问题的详细信息。
- 输入:
{ "issue_id_or_url": "string" }(例如,"12345" 或 "https://sentry.example.com/organizations/org/issues/12345/")
-
list_sentry_projects- 说明:列出配置的 Sentry 组织中的所有项目。
- 输入:
{}(无需参数)
-
list_sentry_issues- 说明:列出特定项目的问题,可选择按查询或状态筛选。
- 输入:
{ "project_slug": "string", "query": "string" (optional), "status": "resolved" | "unresolved" | "ignored" (optional) }
-
get_sentry_event_details- 说明:检索项目中特定事件 ID 的详细信息。
- 输入:
{ "project_slug": "string", "event_id": "string" }
-
update_sentry_issue_status- 说明:更新 Sentry 问题的状态。
- 输入:
{ "issue_id": "string", "status": "resolved" | "ignored" | "unresolved" }
-
create_sentry_issue_comment- 说明:为 Sentry 问题添加评论。
- 输入:
{ "issue_id": "string", "comment_text": "string" }
安装与设置
- 克隆/放置项目: 克隆此仓库,或将项目文件放在所需位置。
- 安装依赖: 进入项目目录(
sentry-selfhosted-mcp)并运行:cd <path/to/sentry-selfhosted-mcp> npm install - 构建服务: 在项目目录中编译 TypeScript 代码:
这会在npm run buildbuild/目录中生成可执行 JavaScript 文件。
配置
此服务需要设置以下环境变量:
SENTRY_URL:自托管 Sentry 实例的基础 URL(例如,https://sentry.beoflow.app)。SENTRY_AUTH_TOKEN:Sentry API 身份验证令牌(请确保其具有所需的权限范围,例如issue:read、project:read、event:read、issue:write、comment:write)。SENTRY_ORG_SLUG:Sentry 组织的 slug(例如,beoflow)。
MCP 客户端配置示例:
将以下条目添加到 MCP 客户端的配置文件中(例如,VS Code 扩展的 cline_mcp_settings.json,或 Claude.app 的 claude_desktop_config.json):
"sentry-selfhosted-mcp": {
"command": "node",
"args": [
"<full/path/to/sentry-selfhosted-mcp/build/index.js>"
],
"env": {
"SENTRY_URL": "YOUR_SENTRY_URL",
"SENTRY_AUTH_TOKEN": "YOUR_SENTRY_AUTH_TOKEN",
"SENTRY_ORG_SLUG": "YOUR_SENTRY_ORG_SLUG"
},
"disabled": false,
"autoApprove": [],
"transportType": "stdio"
}
将 YOUR_SENTRY_URL、YOUR_SENTRY_AUTH_TOKEN 和 YOUR_SENTRY_ORG_SLUG 替换为实际值。
更新设置文件后,MCP 客户端应会自动连接到服务。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。