@megamcp/sentinel 0.1.0 → 0.1.1

package/README.md

@@ -6,14 +6,24 @@ 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
-npm install
-npm run build
-
-# one-shot check of all targets (exits non-zero if any are DOWN)
-npm run check
+## 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
 
 # continuous watch
 npm run watch          # every 60s

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { checkTargets } from "./orchestrate.js";
 import { renderResult, renderSummary } from "./format.js";
-const USAGE = "Usage: megamcp-sentinel <check|watch> [targetId] [--json]";
+const USAGE = "Usage: megamcp-sentinel <check|watch> [targetId|url] [--json]";
 async function main() {
     const argv = process.argv.slice(2);
     const cmd = argv[0] ?? "check";

package/dist/orchestrate.js

@@ -9,10 +9,10 @@ export function configPath() {
  * Returns the results in config order.
  */
 export async function checkTargets(filterId) {
-    const { targets } = loadConfig(configPath());
-    const selected = filterId ? targets.filter((t) => t.id === filterId) : targets;
+    const targets = filterId && isHttpUrl(filterId) ? [targetFromUrl(filterId)] : loadConfig(configPath()).targets;
+    const selected = filterId && !isHttpUrl(filterId) ? targets.filter((t) => t.id === filterId) : targets;
     if (filterId && selected.length === 0) {
-        throw new Error(`No target matched id: ${filterId}`);
+        throw new Error(`No target matched id or URL: ${filterId}`);
     }
     const results = [];
     for (const target of selected) {
@@ -31,3 +31,15 @@ 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,6 +1,6 @@
 {
   "name": "@megamcp/sentinel",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MegaMCP Sentinel — an MCP server that monitors the health of other MCP servers.",
   "license": "UNLICENSED",
   "type": "module",