badgr-mcp-doctor 0.1.0

package/README.md

@@ -0,0 +1,132 @@
+# badgr-mcp-doctor
+
+Diagnose MCP server problems — SSE connectivity, malformed events, tools/list failures, timeouts — in one command.
+
+```bash
+npx badgr-mcp-doctor --url http://localhost:3000/sse
+```
+
+**Free. No signup required.** Runs entirely on your machine.
+
+---
+
+## The problem it solves
+
+MCP servers fail silently. Your coding agent stops calling tools but gives no useful error. Is the server down? Is SSE broken? Are events malformed? Did `tools/list` time out? `badgr-mcp-doctor` runs the full diagnostic sequence and tells you exactly what's wrong.
+
+---
+
+## Quick start
+
+```bash
+# Diagnose an MCP server
+npx badgr-mcp-doctor --url http://localhost:3000/sse
+
+# Machine-readable JSON (for CI or scripts)
+npx badgr-mcp-doctor --url http://localhost:3000/sse --json
+
+# Dry-run a specific tool
+npx badgr-mcp-doctor --url http://localhost:3000/sse --tool my_tool_name
+
+# Longer timeout for slow servers
+npx badgr-mcp-doctor --url http://localhost:3000/sse --timeout-ms 20000
+
+# Show optional hosted monitoring link
+npx badgr-mcp-doctor connect
+```
+
+---
+
+## CLI flags
+
+| Flag | Description |
+|------|-------------|
+| `--url <url>` | MCP server SSE endpoint, e.g. `http://localhost:3000/sse` |
+| `--timeout-ms <n>` | Connection timeout in milliseconds (default: `10000`) |
+| `--tool <name>` | Optional: dry-run a specific tool by name |
+| `--json` | Output machine-readable JSON |
+
+**Commands:**
+
+| Command | Description |
+|---------|-------------|
+| `connect` | Show the optional AI Badgr hosted MCP monitoring link |
+
+**Exit codes:** `0` = all checks passed or warnings only, `1` = one or more failures, `2` = bad usage
+
+---
+
+## What it checks
+
+Each diagnostic runs in sequence and stops early if a hard failure is found:
+
+| Step | Check |
+|------|-------|
+| 1 | **HTTP connection** — server responds to the SSE endpoint |
+| 2 | **SSE event parsing** — events arrive and are valid JSON |
+| 3 | **tools/list** — JSON-RPC call returns a list of tool objects |
+| 4 | **Dry-run tool call** — invokes the first tool (or `--tool`) with `{dryRun: true}` |
+
+---
+
+## Example output
+
+```
+badgr-mcp-doctor — http://localhost:3000/sse
+
+  ✓  HTTP connection: 200 OK
+  ✓  SSE events: valid JSON payloads received
+  ✗  tools/list: timeout after 10000ms
+
+  The server connected but tools/list never responded.
+  Common causes: server still initializing, blocking startup code, wrong endpoint path.
+```
+
+```
+badgr-mcp-doctor — http://localhost:3000/sse
+
+  ✓  HTTP connection: 200 OK
+  ✓  SSE events: valid JSON payloads received
+  ✓  tools/list: 4 tools found (search, read_file, write_file, run_command)
+  ✓  Dry-run tool call: search responded without error
+```
+
+---
+
+## TypeScript API
+
+```ts
+import { runMcpDoctor } from "badgr-mcp-doctor";
+
+const result = await runMcpDoctor({
+  url: "http://localhost:3000/sse",
+  timeoutMs: 15_000,
+  toolName: "my_tool",  // optional: dry-run a specific tool
+});
+
+for (const check of result.checks) {
+  console.log(check.status, check.label, check.detail);
+}
+```
+
+**Types:**
+
+```ts
+interface McpDoctorOptions {
+  url: string;
+  timeoutMs?: number;   // default: 10000
+  toolName?: string;
+}
+
+interface McpDoctorResult {
+  checks: DiagnosticCheck[];
+  report: JsonReport;
+}
+```
+
+---
+
+## Requirements
+
+- Node.js 18+
+- An MCP server running and accessible at the given URL

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import { createLogger, fireTelemetry, formatChecks, parseNumber } from "badgr-shared";
+import { runMcpDoctor } from "./index.js";
+fireTelemetry({ package: "badgr-mcp-doctor", command: process.argv[2] });
+function readArg(name) {
+    const index = process.argv.indexOf(name);
+    return index >= 0 ? process.argv[index + 1] : undefined;
+}
+const command = process.argv[2];
+if (!command || command === "--help" || command === "-h") {
+    console.log(`badgr-mcp-doctor — local MCP server diagnostics
+
+Usage:
+  npx badgr-mcp-doctor --url <sse-url>
+  npx badgr-mcp-doctor --url <sse-url> --json
+  npx badgr-mcp-doctor connect
+
+Flags:
+  --url <url>            MCP server SSE endpoint (e.g. http://localhost:3000/sse)
+  --timeout-ms <n>       Connection timeout in milliseconds (default: 10000)
+  --tool <name>          Optional tool name for a dry-run call
+  --json                 Output machine-readable JSON
+
+Commands:
+  connect                Show the optional AI Badgr hosted monitoring link
+
+Exit codes:
+  0  All checks passed or warnings only
+  1  One or more checks failed
+  2  Bad usage (missing required flag)
+
+No signup required. Hosted monitoring is always optional.
+
+Environment:
+  BADGR_TELEMETRY=0      Disable anonymous usage telemetry`);
+    process.exit(0);
+}
+if (command === "connect") {
+    console.log("Monitor this MCP server continuously with AI Badgr:");
+    console.log("https://aibadgr.com/mcp/connect");
+    console.log("");
+    console.log("Signup is only required if you enable recurring hosted monitoring.");
+    process.exit(0);
+}
+const url = readArg("--url");
+if (!url) {
+    console.error("Error: --url is required");
+    console.error("Usage: npx badgr-mcp-doctor --url http://localhost:3000/sse [--json]");
+    process.exit(2);
+}
+const json = process.argv.includes("--json");
+const result = await runMcpDoctor({ url, timeoutMs: parseNumber(readArg("--timeout-ms")), toolName: readArg("--tool") });
+const logger = createLogger(json);
+if (json) {
+    logger.report(result.report);
+}
+else {
+    logger.line("badgr-mcp-doctor report");
+    logger.line("");
+    logger.line(formatChecks(result.checks));
+    logger.line("");
+    logger.line(`Status: ${result.report.status}`);
+    logger.line("");
+    logger.line("Optional: monitor this MCP server continuously with AI Badgr:");
+    logger.line("  npx badgr-mcp-doctor connect");
+}
+process.exitCode = result.report.status === "failed" ? 1 : 0;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,aAAa,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEzE,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;2DAwB6C,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;IAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC7B,IAAI,CAAC,GAAG,EAAE,CAAC;IACT,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;IACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACzH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AAClC,IAAI,IAAI,EAAE,CAAC;IACT,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;KAAM,CAAC;IACN,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC7E,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC;AACD,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import { type DiagnosticCheck, type JsonReport } from "badgr-shared";
+export interface McpDoctorOptions {
+    url: string;
+    timeoutMs?: number;
+    toolName?: string;
+}
+export interface McpDoctorResult {
+    checks: DiagnosticCheck[];
+    report: JsonReport;
+}
+export declare function parseSseEvents(chunk: string): DiagnosticCheck[];
+export declare function runMcpDoctor(options: McpDoctorOptions): Promise<McpDoctorResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0D,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7H,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC;CACpB;AAOD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAgB/D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqCtF"}

package/dist/index.js

@@ -0,0 +1,139 @@
+import { checkToFinding, createReport, reportStatusFromFindings } from "badgr-shared";
+export function parseSseEvents(chunk) {
+    const checks = [];
+    const events = chunk.split(/\r?\n\r?\n/).filter(Boolean);
+    for (const event of events) {
+        const dataLines = event.split(/\r?\n/).filter((line) => line.startsWith("data:"));
+        if (dataLines.length === 0)
+            continue;
+        const payload = dataLines.map((line) => line.slice(5).trimStart()).join("\n");
+        try {
+            JSON.parse(payload);
+            checks.push({ name: "sse-parse", status: "pass", message: "SSE event contained valid JSON payload" });
+        }
+        catch {
+            checks.push({ name: "sse-parse", status: "fail", message: "SSE event contained malformed multiline payload", details: { payloadPreview: payload.slice(0, 120) } });
+        }
+    }
+    if (checks.length === 0)
+        checks.push({ name: "sse-parse", status: "warn", message: "No SSE data events observed during parsing window" });
+    return checks;
+}
+export async function runMcpDoctor(options) {
+    const timeoutMs = options.timeoutMs ?? 10_000;
+    const checks = [];
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(options.url, { headers: { accept: "text/event-stream, application/json" }, signal: controller.signal });
+        checks.push({ name: "connection", status: response.ok ? "pass" : "fail", message: response.ok ? "connection established" : `connection failed with HTTP ${response.status}` });
+        const contentType = response.headers.get("content-type") ?? "";
+        if (contentType.includes("text/event-stream")) {
+            const text = await readSomeText(response, timeoutMs);
+            checks.push(...parseSseEvents(text));
+        }
+    }
+    catch (error) {
+        checks.push({ name: "connection", status: "fail", message: error instanceof Error && error.name === "AbortError" ? `connection timed out after ${timeoutMs / 1000}s` : `connection failed: ${String(error)}` });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    const rpcChecks = await runJsonRpcChecks(options.url, timeoutMs, options.toolName);
+    checks.push(...rpcChecks);
+    const findings = checks.map((check) => checkToFinding(check, "MCP"));
+    const status = reportStatusFromFindings(findings);
+    const nextCommand = "npx @aibadgr/mcp-doctor connect";
+    const report = createReport({
+        tool: "mcp-doctor",
+        status,
+        summary: status === "failed" ? "MCP server has failing diagnostics" : status === "warning" ? "MCP server has warnings" : "MCP server diagnostics passed",
+        findings,
+        recommendedActions: buildRecommendedActions(checks),
+        nextCommand,
+        actionUrl: "https://aibadgr.com/mcp/connect",
+        metadata: { url: options.url, timeoutMs },
+    });
+    return { checks, report };
+}
+async function readSomeText(response, timeoutMs) {
+    if (!response.body)
+        return await response.text();
+    const reader = response.body.getReader();
+    const timeout = new Promise((_, reject) => setTimeout(() => reject(new Error("read timeout")), Math.min(timeoutMs, 1500)));
+    try {
+        const { value } = await Promise.race([reader.read().then((result) => result), timeout.then((value) => ({ value, done: false }))]);
+        return Buffer.from(value ?? new Uint8Array()).toString("utf8");
+    }
+    catch {
+        return "";
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+async function runJsonRpcChecks(url, timeoutMs, toolName) {
+    const checks = [];
+    const endpoint = url.replace(/\/sse\/?$/, "");
+    const tools = await callJsonRpc(endpoint, "tools/list", {}, timeoutMs);
+    if (tools.timedOut) {
+        checks.push({ name: "tools-list", status: "fail", message: `tools/list timed out after ${timeoutMs / 1000}s` });
+        return checks;
+    }
+    if (tools.error) {
+        checks.push({ name: "tools-list", status: "warn", message: `tools/list could not be checked over JSON-RPC: ${tools.error}` });
+        return checks;
+    }
+    const result = tools.response?.result;
+    const count = Array.isArray(result?.tools) ? result.tools.length : 0;
+    checks.push({ name: "tools-list", status: Array.isArray(result?.tools) ? "pass" : "fail", message: Array.isArray(result?.tools) ? `tools/list returned ${count} tools` : "tools/list returned malformed result" });
+    const dryRunName = toolName ?? (Array.isArray(result?.tools) && typeof result.tools[0]?.name === "string" ? String(result.tools[0].name) : undefined);
+    if (!dryRunName) {
+        checks.push({ name: "dry-run-tool", status: "warn", message: "No tool available for dry-run call" });
+        return checks;
+    }
+    const dryRun = await callJsonRpc(endpoint, "tools/call", { name: dryRunName, arguments: { dryRun: true } }, timeoutMs);
+    if (dryRun.timedOut)
+        checks.push({ name: "dry-run-tool", status: "fail", message: `tool call timed out after ${timeoutMs / 1000}s` });
+    else if (dryRun.error)
+        checks.push({ name: "dry-run-tool", status: "warn", message: `dry-run tool call returned an error: ${dryRun.error}` });
+    else
+        checks.push({ name: "dry-run-tool", status: "pass", message: "dry-run tool call returned a result" });
+    return checks;
+}
+async function callJsonRpc(url, method, params, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json", accept: "application/json" },
+            body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        if (!response.ok)
+            return { error: `HTTP ${response.status}` };
+        return { response: JSON.parse(text) };
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === "AbortError")
+            return { timedOut: true };
+        return { error: String(error) };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function buildRecommendedActions(checks) {
+    const actions = [];
+    if (checks.some((check) => check.name === "sse-parse" && check.status === "fail"))
+        actions.push("Fix malformed multiline SSE event payloads");
+    if (checks.some((check) => check.message.includes("timed out")))
+        actions.push("Add tool-level timeout handling or reduce long-running tool work");
+    if (checks.some((check) => check.name === "tools-list" && check.status !== "pass"))
+        actions.push("Verify the MCP tools/list JSON-RPC response shape");
+    actions.push("Monitor this MCP server continuously with AI Badgr");
+    return actions;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "badgr-mcp-doctor",
+  "version": "0.1.0",
+  "description": "CLI diagnostics for MCP connection, tools/list, timeouts, SSE parsing, and dry-run tool calls.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": { "badgr-mcp-doctor": "dist/cli.js" },
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "files": ["dist", "README.md"],
+  "scripts": { "build": "tsc -b", "typecheck": "tsc -b --pretty false", "test": "vitest run" },
+  "dependencies": { "badgr-shared": "0.1.1" },
+  "engines": { "node": ">=18.0.0" },
+  "keywords": ["mcp", "sse", "diagnostics", "tools", "timeout"],
+  "license": "MIT"
+}