@megamcp/sentinel 0.1.1 → 0.1.2

package/README.md

@@ -6,24 +6,14 @@ It ships two ways:
 - a **CLI** (`check` / `watch`) for cron and CI, and
 - an **MCP server** (`list_targets`, `check_target`, `health_summary`) — i.e. an MCP server that monitors MCP servers.
 
-## Quick start
-
-```bash
-npx @megamcp/sentinel check <url>
-```
-
-For local development:
-
-```bash
-npm install
-npm run build
-
-# one-shot check of all targets (exits non-zero if any are DOWN)
-npm run check
-
-# or check one configured target / ad-hoc HTTP MCP endpoint
-npm run check -- echo-sample
-npm run check -- https://example.com/mcp
+## Quick start
+
+```bash
+npm install
+npm run build
+
+# one-shot check of all targets (exits non-zero if any are DOWN)
+npm run check
 
 # continuous watch
 npm run watch          # every 60s

package/dist/cli.js

@@ -1,14 +1,30 @@
 #!/usr/bin/env node
 import { checkTargets } from "./orchestrate.js";
 import { renderResult, renderSummary } from "./format.js";
-const USAGE = "Usage: megamcp-sentinel <check|watch> [targetId|url] [--json]";
+import { runCheck } from "./monitor.js";
+const USAGE = "Usage: megamcp-sentinel <check|watch> [targetId|http-url] [--json]";
+function isHttpUrl(value) {
+    return value !== undefined && /^https?:\/\//i.test(value);
+}
+function targetFromUrl(url) {
+    const parsed = new URL(url);
+    return {
+        id: `url-${parsed.hostname.replace(/[^a-z0-9-]/gi, "-").toLowerCase()}`,
+        label: parsed.hostname,
+        transport: { type: "http", url },
+        minTools: 1,
+        latencyBudgetMs: 5000,
+    };
+}
 async function main() {
     const argv = process.argv.slice(2);
     const cmd = argv[0] ?? "check";
     const asJson = argv.includes("--json");
     const positional = argv.slice(1).filter((a) => !a.startsWith("--"));
     if (cmd === "check") {
-        const results = await checkTargets(positional[0]);
+        const results = isHttpUrl(positional[0])
+            ? [(await runCheck(targetFromUrl(positional[0]), { fingerprint: null, tools: [] })).result]
+            : await checkTargets(positional[0]);
         if (asJson) {
             console.log(JSON.stringify(results, null, 2));
         }

package/dist/orchestrate.js

@@ -9,10 +9,10 @@ export function configPath() {
  * Returns the results in config order.
  */
 export async function checkTargets(filterId) {
-    const targets = filterId && isHttpUrl(filterId) ? [targetFromUrl(filterId)] : loadConfig(configPath()).targets;
-    const selected = filterId && !isHttpUrl(filterId) ? targets.filter((t) => t.id === filterId) : targets;
+    const { targets } = loadConfig(configPath());
+    const selected = filterId ? targets.filter((t) => t.id === filterId) : targets;
     if (filterId && selected.length === 0) {
-        throw new Error(`No target matched id or URL: ${filterId}`);
+        throw new Error(`No target matched id: ${filterId}`);
     }
     const results = [];
     for (const target of selected) {
@@ -31,15 +31,3 @@ export async function checkTargets(filterId) {
     }
     return results;
 }
-function isHttpUrl(value) {
-    return /^https?:\/\//i.test(value);
-}
-function targetFromUrl(url) {
-    return {
-        id: url,
-        label: url,
-        transport: { type: "http", url },
-        minTools: 1,
-        latencyBudgetMs: 5000,
-    };
-}

package/package.json

@@ -1,28 +1,22 @@
 {
   "name": "@megamcp/sentinel",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MegaMCP Sentinel — an MCP server that monitors the health of other MCP servers.",
   "license": "UNLICENSED",
-  "type": "module",
-  "files": [
-    "dist/",
-    "README.md",
-    "docs-run-production.md",
-    "run-check.ps1",
-    "sentinel.config.json"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
+  "type": "module",
   "bin": {
+    "sentinel": "dist/cli.js",
     "megamcp-sentinel": "dist/cli.js",
     "megamcp-inspect": "dist/inspect.js",
     "megamcp-sentinel-report": "dist/report.js"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "sentinel.config.json"
+  ],
   "scripts": {
-    "build": "tsc",
-    "prepack": "npm run build",
+    "build": "tsc",
     "start": "node dist/server.js",
     "check": "node dist/cli.js check",
     "watch": "node dist/cli.js watch",

package/docs-run-production.md

@@ -1,27 +0,0 @@
-# Running Sentinel in production (Windows)
-
-`run-check.ps1` runs every configured check once and appends a timestamped JSON record to `logs/runs.jsonl`. Per-target rolling history is also kept in `state/`.
-
-## Enable 24/7 monitoring (every 15 minutes, hidden)
-
-Run this once in PowerShell (it sets up a recurring Scheduled Task — OS-level persistence, so it needs your authorization):
-
-```powershell
-schtasks /Create /TN "MegaMCP Sentinel" `
-  /TR "powershell.exe -NonInteractive -WindowStyle Hidden -ExecutionPolicy Bypass -File `"$env:USERPROFILE\Desktop\MegaMCP\sentinel\run-check.ps1`"" `
-  /SC MINUTE /MO 15 /F
-```
-
-## Check / run / disable
-
-```powershell
-schtasks /Query  /TN "MegaMCP Sentinel" /FO LIST   # status + next run
-schtasks /Run    /TN "MegaMCP Sentinel"            # run now
-schtasks /Delete /TN "MegaMCP Sentinel" /F         # remove it
-```
-
-## Where results go
-- `logs/runs.jsonl` — one JSON object per run: `{ at, results: [...] }`
-- `state/<target>.json` — rolling per-target history + last-known tool schema (for drift)
-
-When the hosted version ships, this same wrapper logic moves to a server-side cron / Vercel Cron / GitHub Action feeding the public status board.

package/run-check.ps1

@@ -1,13 +0,0 @@
-# MegaMCP Sentinel - production check wrapper (for Windows Task Scheduler).
-# Runs all configured checks and appends one timestamped JSON line to logs\runs.jsonl.
-$ErrorActionPreference = 'Continue'
-$node = Join-Path $env:LOCALAPPDATA 'Programs\nodejs'
-$env:Path = "$node;$env:Path"
-$proj = Split-Path -Parent $MyInvocation.MyCommand.Definition
-Set-Location $proj
-New-Item -ItemType Directory -Force (Join-Path $proj 'logs') | Out-Null
-$stamp = (Get-Date).ToString('o')
-$out = (& node 'dist\cli.js' check --json) -join "`n"
-try { $parsed = $out | ConvertFrom-Json } catch { $parsed = @{ error = 'check failed'; raw = $out } }
-$line = [pscustomobject]@{ at = $stamp; results = $parsed } | ConvertTo-Json -Depth 8 -Compress
-Add-Content -Path (Join-Path $proj 'logs\runs.jsonl') -Value $line