使用说明
哨兵MCP服务器
@zereight/哨兵服务器
哨兵MCP(模型上下文协议)服务器。允许与Sentry API交互以获取问题和事件详细信息。
用法
与Claude、Roo Code、Cline等一起使用。
将以下配置添加到MCP设置文件中(例如。, mcp_settings.json):
{
"mcpServers": {
"sentry-server-npm": {
"command": "npx",
"args": [
"-y",
"@zereight/sentry-server"
],
"env": {
"SENTRY_AUTH_TOKEN": "YOUR_SENTRY_AUTH_TOKEN", // Required
"SENTRY_ORG_SLUG": "YOUR_ORG_SLUG", // Required: Your Sentry organization slug
"SENTRY_PROJECT_NAMES": "YOUR_PROJECT1,YOUR_PROJECT2", // Required: Comma-separated Sentry project slugs
"SENTRY_BASE_URL": "YOUR_SENTRY_BASE_URL" // Optional: Defaults to https://sentry.io
},
"disabled": false
}
}
}
替换占位符值,如 "YOUR_SENTRY_AUTH_TOKEN", "YOUR_ORG_SLUG",以及 "YOUR_PROJECT1,YOUR_PROJECT2" 与您的实际哨兵详细信息。提供以逗号分隔的项目段。Project slug用于Sentry URL(例如。, https://<org-slug>.sentry.io/settings/projects/<project-slug>/).可以在“用户设置”>“身份验证令牌”中生成身份验证令牌。
与Cursor(或直接CLI)一起使用
当与Cursor一起使用或直接运行时,您可以设置环境变量并按如下方式运行服务器:
env SENTRY_AUTH_TOKEN=YOUR_SENTRY_AUTH_TOKEN \
SENTRY_ORG_SLUG=YOUR_ORG_SLUG \
SENTRY_PROJECT_NAMES=YOUR_PROJECT1,YOUR_PROJECT2 \
SENTRY_BASE_URL=YOUR_SENTRY_BASE_URL \
npx @zereight/sentry-server
SENTRY_AUTH_TOKEN(必填):您的Sentry身份验证令牌。SENTRY_ORG_SLUG(必填):你的哨兵组织的蛞蝓。SENTRY_PROJECT_NAMES(必填):您的哨兵项目的逗号分隔名称(slugs)。SENTRY_BASE_URL(可选):Sentry实例的基本URL(例如,用于自托管)。默认为https://sentry.io.
工具🛠️
-
get_sentry_issue- 获取特定哨兵问题的详细信息。 ℹ️
- 输入:
issue_id_or_url(string,必填):哨兵问题ID或问题页面的完整URL。
- 返回:有关问题的详细信息(JSON字符串)。
-
list_organization_projects- 列出已配置的Sentry组织的所有项目。 📂
- 输入:无
- 返回:项目对象列表(JSON字符串)。
-
list_project_issues- 列出特定项目的问题,并可进行筛选。🐛
- 输入:
organization_slug(string,可选):组织的slug。默认为SENTRY_ORG_SLUGenv变种。project_slug(string,必填):列出项目问题的slug。query(字符串,可选):哨兵搜索查询以过滤问题(例如,“是:未解决的”,“受让人:我”)。statsPeriod(字符串,可选):统计的时间段(例如,“24小时”、“14天”、“自动”)。cursor(字符串,可选):用于获取下一页/上一页的分页光标。
- 返回:问题对象和分页信息的列表(JSON字符串)。
-
get_event_details- 获取项目中特定事件的详细信息。 📄
- 输入:
organization_slug(string,可选):组织的slug。默认为SENTRY_ORG_SLUGenv变种。project_slug(string,必填):事件所属项目的slug。event_id(string,必填):要检索的事件的ID。
- 返回:关于特定事件的详细信息(JSON字符串)。
环境变量配置
在运行服务器之前,您 必须 设置以下环境变量:
SENTRY_AUTH_TOKEN=YOUR_SENTRY_AUTH_TOKEN
SENTRY_ORG_SLUG=YOUR_ORG_SLUG
SENTRY_PROJECT_NAMES=YOUR_PROJECT_NAME1,YOUR_PROJECT_NAME2
您还可以选择设置:
SENTRY_BASE_URL=YOUR_SENTRY_BASE_URL # Default: https://sentry.io
检查器将提供一个URL,用于访问浏览器中的调试工具。
许可证
MIT许可证
