Watchgoose MCP

Watchgoose MCP 将支持 MCP 的 AI 客户端连接到 Watchgoose Management API。它可以让你查看 cron 与重复任务的监控情况，并且只有在你显式启用写入时，才可对检查（check）进行更改。

要求

• Node.js 20 或更高版本

• 来自项目设置的项目级 Watchgoose API 密钥

当你只需要检查状态和状态历史时，请使用 hcr_ 只读密钥。当你还需要 ping、集成或对检查进行更改时，请使用 hcw_ 读写密钥。

Related MCP server: uptrack-mcp

Claude Desktop

将以下条目添加到 claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

Claude Code

claude mcp add --env WATCHGOOSE_API_KEY=hcr_your_project_key \
  --transport stdio --scope user watchgoose -- npx -y watchgoose-mcp

运行 claude mcp get watchgoose 以检查连接。

Cursor

在你的项目中创建 .cursor/mcp.json，或将相同的条目添加到你的用户 MCP 配置中：

{
  "mcpServers": {
    "watchgoose": {
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

VS Code

创建 .vscode/mcp.json：

{
  "servers": {
    "watchgoose": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "watchgoose-mcp"],
      "env": {
        "WATCHGOOSE_API_KEY": "hcr_your_project_key"
      }
    }
  }
}

运行 MCP: List Servers，然后启动 watchgoose。

环境变量

服务器会在本地对密钥前缀进行分类，绝不会探测 API 来推断访问权限。设置 WATCHGOOSE_ENABLE_WRITES=true 无法为只读密钥赋予额外的访问权限。

工具

检查使用稳定的 40 字符 unique_key 值来标识。UUID、ping URL 和集成 UUID 仅在服务器内部使用，不会显示给 AI 客户端。

集成分配使用确切的集成名称。名称必须非空，并且在项目内唯一。

列表结果的上限为 100 个检查、100 条 ping、200 条 flip 记录和 100 个集成。每个序列化后的工具结果同样以 24,000 字符为上限。当有条目被省略时，结果中会包含相应的元数据。

安全性

• 即使使用 hcw_ 密钥，写入默认也是禁用的。

• API 密钥仅通过 X-Api-Key 请求头发送，绝不会被记录或返回。

• API 重定向会被拒绝，因此凭据不会被转发到其他主机。

• 检查的 UUID、ping 与更新 URL、集成 UUID，以及未知的未来 API 字段，都会从输出中移除。

• 每条 ping 仅保留 type、date、n、scheme、method 和 duration。源 IP 地址、用户代理、运行 ID 和请求体 URL 都会被移除。

• 永远不会请求 ping 的请求体。

• 服务器不包含任何遥测功能。

请保护包含 API 密钥的客户端配置文件。建议使用专用项目，并选择能提供所需工具的最低权限密钥。当密钥不再使用时，请从 Watchgoose 项目设置中吊销该密钥。

开发

npm install
npm run format:check
npm run lint
npm run typecheck
npm test
npm run publish:dry-run

生产环境集成测试为可选启用（opt-in），需要专用的测试项目密钥。它们绝不会在 CI 中运行。

许可证

MIT