Watchgoose MCP

Watchgoose MCP подключает MCP-совместимых ИИ-клиентов к Management API Watchgoose. Он позволяет просматривать мониторинг cron и повторяющихся задач, при этом изменения проверок доступны только при явном включении записи.

Требования

• Node.js 20 или новее

• Ключ API Watchgoose с областью действия проекта из Настроек проекта

Используйте ключ только для чтения hcr_, если вам нужны только состояние проверок и история статусов. Используйте ключ чтения-записи 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, URL пингов и UUID интеграций используются только внутри сервера и не показываются ИИ-клиенту.

Назначения интеграций используют точные имена интеграций. Имена должны быть непустыми и уникальными в пределах проекта.

Результаты списков ограничены 100 проверками, 100 пингами, 200 флипами и 100 интеграциями. Каждый сериализованный результат инструмента также ограничен 24 000 символов. Результаты включают метаданные, когда записи опущены.

Безопасность

• Запись отключена по умолчанию, даже с ключом hcw_.

• Ключ API отправляется только в заголовке X-Api-Key и никогда не логируется и не возвращается.

• Перенаправления API отклоняются, чтобы учетные данные не могли быть пересланы на другой хост.

• UUID проверок, URL пингов и обновлений, UUID интеграций и неизвестные будущие поля API удаляются из вывода.

• Пинги сохраняют только type, date, n, scheme, method и duration. IP-адреса источников, пользовательские агенты, ID запусков и URL тел удаляются.

• Тела пингов никогда не запрашиваются.

• Сервер не имеет телеметрии.

Защищайте файлы конфигурации клиента, содержащие ключи API. Предпочитайте выделенный проект и ключ с наименьшими привилегиями, который открывает нужные вам инструменты. Отзывайте ключ в настройках проекта Watchgoose, когда он больше не используется.

Разработка

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

Интеграционные тесты в продакшене являются опциональными и требуют выделенных ключей тестового проекта. Они никогда не запускаются в CI.

Лицензия

MIT