errorwatch

errorwatch

errorwatch 通过一个小巧的二进制程序监控 Sentry 账户。Agent 可以确认令牌所属的身份，遍历组织、项目和版本，使用 Sentry 自有的查询语法搜索问题流，查看问题及其最新事件，更改问题状态，并读取或发表评论。它可以从命令行运行，也可以作为供 Agent 使用的 MCP 服务运行。

需要 Sentry 身份验证令牌。将其放入 SENTRY_AUTH_TOKEN 环境变量中；它会作为 Bearer 令牌发送到 API，且绝不会出现在输出中。如果缺少此变量，每次调用都会失败并指出该变量的名称。

这是 Sentry API 的核心子集，而非完整功能：不包括托管文档搜索工具、AI 自动修复（Seer）工具、性能分析／追踪／跨度搜索、DSN 和项目创建及其他管理操作，也不包括问题以外的组织统计信息。

安装

npx @reneturcios/errorwatch list-organizations

或者运行容器映像：

docker run -i -e SENTRY_AUTH_TOKEN ghcr.io/cloudcorprecords/errorwatch

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

export SENTRY_AUTH_TOKEN="your auth token"

errorwatch whoami
errorwatch list-organizations
errorwatch list-projects --org acme
errorwatch list-releases --org acme --project web
errorwatch search-issues --org acme --query "is:unresolved TypeError"
errorwatch get-issue --issue-id 123456

errorwatch --version

退出代码：成功时为 0，API 调用失败时为 1（包括缺少 SENTRY_AUTH_TOKEN 的情况），用法错误时为 2。

MCP 服务

同一个二进制程序提供两种使用方式。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/errorwatch mcp

MCP 客户端配置：

{
  "mcpServers": {
    "errorwatch": {
      "command": "npx",
      "args": ["-y", "@reneturcios/errorwatch", "mcp"],
      "env": { "SENTRY_AUTH_TOKEN": "your auth token" }
    }
  }
}

工具

工具	输入	返回内容
whoami	（无）	已通过身份验证的用户或令牌身份（GET /auth/）。
list_organizations	（无）	令牌可访问的组织。
list_projects	organization_slug（必填）	该组织中的项目。
get_project	organization_slug、project_slug（必填）	单个项目的详情。
list_releases	organization_slug、project_slug（必填）	该项目的版本。
search_issues	organization_slug（必填），project_slug、query、limit（可选）	与 Sentry 搜索查询匹配的问题；如果提供了项目，则使用项目问题端点。
get_issue	issue_id（必填）	单个问题的详情。
get_issue_event	issue_id（必填），event_id（可选，默认为 latest）	属于该问题的单个事件。
update_issue	issue_id（必填），status、resolved_in_next_release、assigned_to、has_seen、is_bookmarked、is_subscribed（可选）	更新后的问题；只会发送提供的字段。
list_issue_comments	issue_id（必填）	该问题的评论（备注）。
create_issue_comment	issue_id、text（必填）	创建的评论。

API 调用失败时会报告为工具错误，其中包含 HTTP 状态码；如果 Sentry 提供了 detail 消息，也会一并包含。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

许可证

MIT — 参见 LICENSE。