Staygreen

Staygreen

为使用编码 Agent 构建的应用提供可用性和事件监控：从多个地点进行检查、附带证据的事件，以及每个应用的公开状态页。免费套餐详见 staygreen.io。

此仓库是 Staygreen 的公开问题跟踪器、MCP 服务列表的主页，也是 staygreen 命令行软件包和本地 MCP 服务（CLI.md）的源码，采用 Apache 2.0 许可证。Staygreen 的其余代码将于 2026 年 11 月在此开源。

连接 Agent（MCP）

Staygreen 的 MCP 服务位于 https://staygreen.io/mcp（可流式传输的 HTTP）。每次调用都需要登录；不提供匿名工具。

登录：无需处理令牌

将 https://staygreen.io/mcp 添加到支持登录（OAuth）的 MCP 客户端，然后使用 Staygreen 账户登录并选择工作区。如果你还没有账户，在此注册即可创建 Free 工作区；无需先打开控制面板。此连接可以读取和更改该工作区的监控项，且你必须是该工作区的管理员。

Claude Code：

claude mcp add --transport http staygreen https://staygreen.io/mcp

然后运行 /mcp，选择 staygreen 并进行身份验证。在 Claude 中，将其作为自定义连接器添加，使用相同的 URL。

使用 API 令牌（CI 和脚本）

管理员可在控制面板的 Agents and API 下创建令牌，该令牌为只读或读写权限，且只显示一次。将其作为 Authorization: Bearer <token> 发送。同一令牌可用于 MCP 服务和 REST API（https://staygreen.io/api/v1/<tool>）。

claude mcp add --transport http staygreen https://staygreen.io/mcp \
  --header "Authorization: Bearer $STAYGREEN_API_TOKEN"

本地服务（npm）

staygreen 软件包可作为本地 stdio 服务运行相同的工具，并使用工作区 API 令牌调用 REST API。需要 Node 22 或更高版本。

claude mcp add staygreen -e STAYGREEN_API_TOKEN=… -- npx -y staygreen mcp

没有令牌时，只有 scan_app 可用。Claude Desktop、Cursor 和 VS Code 的配置，以及该软件包的 scan 和 provision 命令，详见 CLI.md。

工具

工具	功能
get_status	一个或所有应用的当前状态：监控项、页面组件和未解决事件
list_monitors	工作区中的监控项，可按应用、类型或状态筛选，并显示每项的上次检查结果
get_uptime	测得的可用时间、停机分钟数、事件计数和每日历史记录。未测量的时间表示无数据，并非 100%
get_response_times	按城市和国家/地区显示监控项的响应时间序列
get_incidents	事件证据和时间线：失败的断言、地点和经过遮蔽的片段
get_ssl_and_domain_expiry	受监控主机的证书和域名到期日期
scan_app	对公开应用 URL 执行一次性扫描。可选密钥仅使用一次，绝不存储。不创建任何内容
provision_app	一次调用即可为应用设置网站检查、SSL 和域名检查、状态页及 cron 心跳
create_monitor	为应用添加一个监控项，并遵循控制面板自身的检查项和套餐限制
pause	暂停一个监控项或某个应用的所有监控项，最长 24 小时，然后自动恢复
draft_incident_update	将事件说明保存为草稿。只有在控制面板中发布后，它才会公开显示

写入操作需要提供 request_id UUID：使用相同输入重复提交该 ID，即可安全重试。删除、告警渠道、团队成员、计费和发布功能不向 Agent 开放。调用共用工作区的额度：Free 套餐每分钟 30 次，Builder 套餐每分钟 120 次。

报告错误或建议功能

提交一个问题。说明你做了什么、预期结果是什么，以及实际发生了什么；注明监控器类型并提供屏幕截图会有所帮助。

问题是公开的。切勿粘贴心跳 URL、API 令牌、标头值或监控器保密的任何其他信息。 心跳 URL 是该心跳唯一的凭据：任何持有它的人都可以发送心跳。如果不小心发布了心跳 URL，请在该心跳的页面中轮换它。

如果遇到安全问题，请勿提交问题，而应使用私密漏洞报告。

在代码能够打开之前，我们不会接受拉取请求。