@kryptosai/mcp-observatory 0.14.0 → 0.14.1

package/dist/src/commands/record-replay.js

@@ -0,0 +1,181 @@
+import os from "node:os";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { defaultCassettesDirectory, loadCassette, saveCassette } from "../cassette.js";
+import { runPromptsCheck } from "../checks/prompts.js";
+import { runResourcesCheck } from "../checks/resources.js";
+import { runToolsCheck } from "../checks/tools.js";
+import { runToolsInvokeCheck } from "../checks/tools-invoke.js";
+import { renderTerminal, } from "../index.js";
+import { runTargetRecording } from "../runner.js";
+import { ReplayTransport } from "../transport/replay-transport.js";
+import { SCHEMA_VERSION } from "../types.js";
+import { buildRunId } from "../utils/ids.js";
+import { compareResponses } from "../verify.js";
+import { TOOL_VERSION } from "../version.js";
+import { ANSI, c, readTargetConfig, targetFromCommand, getPassthroughArgs } from "./helpers.js";
+export function registerRecordReplayCommands(program, bin) {
+    // ── record ─────────────────────────────────────────────────────────────
+    program
+        .command("record")
+        .passThroughOptions()
+        .description("Record a server session to a cassette file for replay.")
+        .argument("[command...]", "Server command and arguments to run.")
+        .option("--target <config>", "Path to a target config JSON file.")
+        .option("--no-color", "Disable colored output.")
+        .action(async (commandArgs, options) => {
+        const target = options.target
+            ? await readTargetConfig(options.target)
+            : targetFromCommand(commandArgs.length > 0 ? commandArgs : getPassthroughArgs());
+        process.stdout.write(`${c(ANSI.dim, "⟳")} Recording session with ${c(ANSI.bold, target.targetId)}...\n`);
+        const { artifact, cassetteEntries } = await runTargetRecording(target, { invokeTools: true });
+        if (!cassetteEntries || cassetteEntries.length === 0) {
+            process.stdout.write(`${c(ANSI.yellow, "⚠")} No traffic recorded.\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const cassette = {
+            version: 1,
+            targetId: target.targetId,
+            recordedAt: new Date().toISOString(),
+            transport: target.adapter === "http" ? "http" : "stdio",
+            entries: cassetteEntries,
+        };
+        const cassettePath = await saveCassette(cassette, defaultCassettesDirectory(process.cwd()));
+        const summary = renderTerminal(artifact);
+        process.stdout.write(`\n${summary}\n`);
+        process.stdout.write(`\n${c(ANSI.green, "✓")} Cassette saved: ${cassettePath}\n`);
+        process.stdout.write(`  ${c(ANSI.dim, `${cassetteEntries.length} entries recorded`)}\n`);
+        process.stdout.write(`\n  Replay offline:  ${c(ANSI.cyan, `${bin} replay ${cassettePath}`)}\n`);
+        process.stdout.write(`  Verify live:     ${c(ANSI.cyan, `${bin} verify ${cassettePath} ${target.adapter === "http" ? `--target <config>` : commandArgs.join(" ")}`)}\n\n`);
+        if (artifact.gate === "fail") {
+            process.exitCode = 1;
+        }
+    });
+    // ── replay ─────────────────────────────────────────────────────────────
+    program
+        .command("replay")
+        .description("Replay a cassette file offline — no live server needed.")
+        .argument("<cassette>", "Path to a cassette JSON file.")
+        .option("--no-color", "Disable colored output.")
+        .action(async (cassettePath) => {
+        const cassette = await loadCassette(cassettePath);
+        process.stdout.write(`${c(ANSI.dim, "⟳")} Replaying cassette for ${c(ANSI.bold, cassette.targetId)} (${cassette.entries.length} entries)...\n`);
+        // Create a target config for the replay
+        const replayTarget = {
+            targetId: cassette.targetId,
+            adapter: "local-process",
+            command: "replay",
+            args: [],
+        };
+        // Build a ReplayTransport and run checks against it
+        const transport = new ReplayTransport(cassette.entries);
+        const client = new Client({ name: "mcp-observatory", version: TOOL_VERSION }, { capabilities: {} });
+        await client.connect(transport);
+        const serverCapabilities = client.getServerCapabilities();
+        const checkContext = {
+            client,
+            serverCapabilities,
+            target: replayTarget,
+            timeoutMs: 10_000,
+            stderrLines: [],
+        };
+        const toolsCheck = await runToolsCheck(checkContext);
+        const promptsCheck = await runPromptsCheck(checkContext);
+        const resourcesCheck = await runResourcesCheck(checkContext);
+        const invokeCheck = await runToolsInvokeCheck(checkContext);
+        await client.close();
+        const checks = [
+            toolsCheck.result,
+            promptsCheck.result,
+            resourcesCheck.result,
+            invokeCheck.result,
+        ];
+        const failCount = checks.filter((ch) => ch.status === "fail").length;
+        const gate = failCount > 0 ? "fail" : "pass";
+        const artifact = {
+            artifactType: "run",
+            schemaVersion: SCHEMA_VERSION,
+            gate,
+            runId: buildRunId(),
+            createdAt: new Date().toISOString(),
+            toolVersion: TOOL_VERSION,
+            target: {
+                targetId: cassette.targetId,
+                adapter: "local-process",
+                command: "replay",
+                args: [],
+                metadata: { source: "cassette", cassettePath },
+            },
+            environment: {
+                platform: `${os.platform()} ${os.release()}`,
+                nodeVersion: process.version,
+            },
+            summary: {
+                total: checks.length,
+                pass: checks.filter((ch) => ch.status === "pass").length,
+                fail: failCount,
+                partial: checks.filter((ch) => ch.status === "partial").length,
+                unsupported: checks.filter((ch) => ch.status === "unsupported").length,
+                flaky: checks.filter((ch) => ch.status === "flaky").length,
+                skipped: checks.filter((ch) => ch.status === "skipped").length,
+                gate,
+            },
+            checks,
+        };
+        process.stdout.write(`\n${renderTerminal(artifact)}\n`);
+        process.stdout.write(`\n${c(ANSI.dim, `Replayed from: ${cassettePath}`)}\n\n`);
+        if (artifact.gate === "fail") {
+            process.exitCode = 1;
+        }
+    });
+    // ── verify ─────────────────────────────────────────────────────────────
+    program
+        .command("verify")
+        .passThroughOptions()
+        .description("Verify a live server still matches a recorded cassette.")
+        .argument("<cassette>", "Path to a cassette JSON file.")
+        .argument("[command...]", "Server command and arguments to run.")
+        .option("--target <config>", "Path to a target config JSON file.")
+        .option("--no-color", "Disable colored output.")
+        .action(async (cassettePath, commandArgs, options) => {
+        const cassette = await loadCassette(cassettePath);
+        const target = options.target
+            ? await readTargetConfig(options.target)
+            : targetFromCommand(commandArgs.length > 0 ? commandArgs : getPassthroughArgs());
+        process.stdout.write(`${c(ANSI.dim, "⟳")} Verifying ${c(ANSI.bold, target.targetId)} against cassette...\n`);
+        const { cassetteEntries } = await runTargetRecording(target, { invokeTools: true });
+        if (!cassetteEntries) {
+            process.stdout.write(`${c(ANSI.red, "✗")} Failed to record live session for comparison.\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const verifyResult = compareResponses(cassette, cassetteEntries);
+        process.stdout.write("\n");
+        for (const entry of verifyResult.entries) {
+            if (entry.status === "pass") {
+                process.stdout.write(`  ${c(ANSI.green, "✓")} ${entry.method}\n`);
+            }
+            else if (entry.status === "fail") {
+                process.stdout.write(`  ${c(ANSI.red, "✗")} ${entry.method}\n`);
+                if (entry.diff) {
+                    for (const line of entry.diff.split("\n")) {
+                        process.stdout.write(`    ${c(ANSI.dim, line)}\n`);
+                    }
+                }
+            }
+            else {
+                process.stdout.write(`  ${c(ANSI.yellow, "?")} ${entry.method} ${c(ANSI.dim, "(missing — server did not respond)")}\n`);
+            }
+        }
+        process.stdout.write("\n");
+        if (verifyResult.failed === 0 && verifyResult.missing === 0) {
+            process.stdout.write(c(ANSI.green, `  ✓ All ${verifyResult.passed} responses match cassette\n`));
+        }
+        else {
+            process.stdout.write(c(ANSI.red, `  ✗ ${verifyResult.failed} changed, ${verifyResult.missing} missing out of ${verifyResult.totalEntries} responses\n`));
+            process.exitCode = 1;
+        }
+        process.stdout.write("\n");
+    });
+}
+//# sourceMappingURL=record-replay.js.map

package/dist/src/commands/record-replay.js.map

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

package/dist/src/commands/scan.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerScanCommands(program: Command, bin: string): void;

package/dist/src/commands/scan.js

@@ -0,0 +1,155 @@
+import { access } from "node:fs/promises";
+import { scanForTargets } from "../discovery.js";
+import { runTarget, } from "../index.js";
+import { TOOL_VERSION } from "../version.js";
+import { ANSI, LOGO, c, useColor } from "./helpers.js";
+// ── Scan implementation ─────────────────────────────────────────────────────
+async function runScan(bin, configPath, invokeTools, securityCheck) {
+    process.stdout.write(useColor() ? c(ANSI.cyan, LOGO) + `  ${c(ANSI.dim, `v${TOOL_VERSION}`)}\n\n` : LOGO + `  v${TOOL_VERSION}\n\n`);
+    if (configPath) {
+        try {
+            await access(configPath);
+        }
+        catch {
+            process.stdout.write(c(ANSI.red, `  ✗ Config file not found: ${configPath}\n\n`));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    const targets = await scanForTargets(configPath);
+    if (targets.length === 0) {
+        process.stdout.write(c(ANSI.yellow, "  No MCP servers found.\n\n"));
+        process.stdout.write(c(ANSI.dim, "  Looked in ~/.claude.json, Claude Desktop config, .mcp.json\n\n"));
+        process.stdout.write("  Test a specific server:\n");
+        process.stdout.write(`    ${c(ANSI.dim, "$")} ${c(ANSI.cyan, `${bin} test npx -y @modelcontextprotocol/server-filesystem .`)}\n\n`);
+        return;
+    }
+    process.stdout.write(c(ANSI.bold, `  Found ${targets.length} MCP server${targets.length === 1 ? "" : "s"}:\n`));
+    for (const t of targets) {
+        process.stdout.write(`  ${c(ANSI.cyan, "●")} ${c(ANSI.bold, t.config.targetId)} ${c(ANSI.dim, `← ${t.source}`)}\n`);
+    }
+    process.stdout.write("\n");
+    const results = [];
+    let passCount = 0;
+    let failCount = 0;
+    let totalTools = 0;
+    let totalPrompts = 0;
+    let totalResources = 0;
+    for (const t of targets) {
+        process.stdout.write(`  ${c(ANSI.dim, "⟳")} Checking ${c(ANSI.bold, t.config.targetId)}...`);
+        try {
+            const artifact = await runTarget(t.config, { invokeTools, securityCheck });
+            const toolsCheck = artifact.checks.find((ch) => ch.id === "tools");
+            const promptsCheck = artifact.checks.find((ch) => ch.id === "prompts");
+            const resourcesCheck = artifact.checks.find((ch) => ch.id === "resources");
+            const toolCount = toolsCheck?.evidence[0]?.itemCount ?? 0;
+            const promptCount = promptsCheck?.evidence[0]?.itemCount ?? 0;
+            const resourceCount = resourcesCheck?.evidence[0]?.itemCount ?? 0;
+            totalTools += toolCount;
+            totalPrompts += promptCount;
+            totalResources += resourceCount;
+            const diagnostics = [];
+            for (const check of artifact.checks) {
+                if (check.status === "fail" || check.status === "partial") {
+                    diagnostics.push(`${check.id}: ${check.message}`);
+                }
+            }
+            const gateIcon = artifact.gate === "pass" ? c(ANSI.green, " ✓") : c(ANSI.red, " ✗");
+            process.stdout.write(`\r  ${gateIcon} ${c(ANSI.bold, t.config.targetId)}${" ".repeat(Math.max(1, 40 - t.config.targetId.length))}`);
+            process.stdout.write(`${c(ANSI.dim, `${toolCount} tools, ${promptCount} prompts, ${resourceCount} resources`)}\n`);
+            if (artifact.fatalError) {
+                process.stdout.write(`    ${c(ANSI.red, "→")} ${artifact.fatalError.split("\n")[0]}\n`);
+            }
+            else if (artifact.gate === "fail" && diagnostics.length > 0) {
+                process.stdout.write(`    ${c(ANSI.dim, "→")} ${diagnostics[0]}\n`);
+            }
+            results.push({ targetId: t.config.targetId, gate: artifact.gate, toolCount, promptCount, resourceCount, diagnostics });
+            if (artifact.gate === "pass")
+                passCount++;
+            else
+                failCount++;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            let friendlyMsg = msg;
+            if (msg.includes("ENOENT") || msg.includes("not found")) {
+                const cmd = t.config.adapter === "http" ? t.config.url : t.config.command;
+                friendlyMsg = `Could not start server — "${cmd}" not found. Is it installed?`;
+            }
+            else if (msg.includes("ECONNREFUSED")) {
+                friendlyMsg = `Server is not running or refused the connection.`;
+            }
+            else if (msg.includes("timed out") || msg.includes("timeout")) {
+                friendlyMsg = `Server took too long to respond.`;
+            }
+            process.stdout.write(`\r  ${c(ANSI.red, "✗")} ${c(ANSI.bold, t.config.targetId)}\n`);
+            process.stdout.write(`    ${c(ANSI.red, friendlyMsg)}\n`);
+            results.push({ targetId: t.config.targetId, gate: "fail", toolCount: 0, promptCount: 0, resourceCount: 0, error: friendlyMsg, diagnostics: [] });
+            failCount++;
+        }
+    }
+    // ── Summary ──────────────────────────────────────────────────────────
+    process.stdout.write("\n");
+    if (failCount === 0) {
+        process.stdout.write(c(ANSI.green, `  ✓ All ${passCount} server${passCount === 1 ? "" : "s"} healthy`));
+        process.stdout.write(c(ANSI.dim, ` — ${totalTools} tools, ${totalPrompts} prompts, ${totalResources} resources\n`));
+    }
+    else {
+        process.stdout.write(c(ANSI.red, `  ✗ ${failCount} of ${passCount + failCount} server${passCount + failCount === 1 ? "" : "s"} failing`));
+        if (totalTools > 0 || totalPrompts > 0 || totalResources > 0) {
+            process.stdout.write(c(ANSI.dim, ` — ${totalTools} tools, ${totalPrompts} prompts, ${totalResources} resources found\n`));
+        }
+        else {
+            process.stdout.write("\n");
+        }
+    }
+    // Show diagnostics for failures or notable partials
+    const issues = results.filter((r) => r.diagnostics.length > 0 && !r.error);
+    if (issues.length > 0) {
+        process.stdout.write("\n");
+        for (const r of issues) {
+            process.stdout.write(`  ${c(ANSI.yellow, r.targetId)}:\n`);
+            for (const d of r.diagnostics.slice(0, 3)) {
+                process.stdout.write(`    ${c(ANSI.dim, "→")} ${d}\n`);
+            }
+        }
+    }
+    // ── Next step ────────────────────────────────────────────────────────
+    process.stdout.write("\n");
+    if (!invokeTools && totalTools > 0) {
+        process.stdout.write(c(ANSI.dim, `  Next: ${c(ANSI.cyan, `${bin} scan deep`)} to also test that tools run\n`));
+    }
+    else {
+        process.stdout.write(c(ANSI.dim, `  Run ${c(ANSI.cyan, `${bin} --help`)} for more commands\n`));
+    }
+    process.stdout.write("\n");
+    if (failCount > 0) {
+        process.exitCode = 1;
+    }
+}
+// ── Register ────────────────────────────────────────────────────────────────
+export function registerScanCommands(program, bin) {
+    const scanCmd = program
+        .command("scan")
+        .description("Check all MCP servers in your Claude configs.")
+        .option("--config <path>", "Path to a specific MCP config file.")
+        .option("--security", "Run security analysis on tool schemas.")
+        .option("--no-color", "Disable colored output.");
+    // `scan` with no subcommand — basic scan
+    scanCmd.action(async (options) => {
+        await runScan(bin, options.config, false, options.security);
+    });
+    // `scan deep` — scan + invoke tools
+    scanCmd
+        .command("deep")
+        .description("Scan and also invoke safe tools to verify they execute.")
+        .option("--config <path>", "Path to a specific MCP config file.")
+        .option("--security", "Run security analysis on tool schemas.")
+        .action(async (options) => {
+        // Inherit parent config option if set
+        const parentConfig = scanCmd.opts().config;
+        const parentSecurity = scanCmd.opts().security;
+        await runScan(bin, options.config ?? parentConfig, true, options.security ?? parentSecurity ?? true);
+    });
+}
+//# sourceMappingURL=scan.js.map

package/dist/src/commands/scan.js.map

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

package/dist/src/commands/score.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerScoreCommands(program: Command): void;

package/dist/src/commands/score.js

@@ -0,0 +1,88 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { generateBadgeSvg } from "../badge.js";
+import { runTarget, writeRunArtifact, } from "../index.js";
+import { defaultRunsDirectory } from "../storage.js";
+import { ANSI, c, formatOutput, targetFromCommand, writeOutput } from "./helpers.js";
+export function registerScoreCommands(program) {
+    // ── score ────────────────────────────────────────────────────────────
+    program
+        .command("score")
+        .passThroughOptions()
+        .description("Score an MCP server's health (0-100).")
+        .argument("<command...>", "Server command and arguments to run.")
+        .option("--format <format>", "terminal, json, junit, markdown, html, or sarif", "terminal")
+        .option("--output <file>", "Write to file instead of stdout.")
+        .option("--no-color", "Disable colored output.")
+        .action(async (commandArgs, options) => {
+        const target = targetFromCommand(commandArgs);
+        process.stdout.write(`${c(ANSI.dim, "⟳")} Scoring ${c(ANSI.bold, target.targetId)}...\n\n`);
+        const artifact = await runTarget(target, { invokeTools: true, securityCheck: true });
+        await writeRunArtifact(artifact, defaultRunsDirectory(process.cwd()));
+        if (options.format !== "terminal") {
+            const output = formatOutput(artifact, options.format);
+            await writeOutput(output, options.format, options.output);
+            return;
+        }
+        const score = artifact.healthScore;
+        if (!score) {
+            process.stdout.write("  Could not compute health score.\n\n");
+            return;
+        }
+        const gradeColor = score.grade === "A" || score.grade === "B" ? ANSI.green
+            : score.grade === "C" ? ANSI.yellow
+                : ANSI.red;
+        process.stdout.write(c(ANSI.bold, `  MCP Health Score: ${c(gradeColor, `${score.overall}/100`)} (${c(gradeColor, score.grade)})\n\n`));
+        for (const dim of score.dimensions) {
+            const filled = Math.round(dim.score / 5);
+            const empty = 20 - filled;
+            const bar = "█".repeat(filled) + "░".repeat(empty);
+            const dimColor = dim.score >= 80 ? ANSI.green : dim.score >= 60 ? ANSI.yellow : ANSI.red;
+            const weightPct = Math.round(dim.weight * 100);
+            process.stdout.write(`  ${dim.name.padEnd(22)} ${c(dimColor, bar)} ${String(dim.score).padStart(3)}  ${c(ANSI.dim, `(weight: ${weightPct}%)`)}\n`);
+        }
+        process.stdout.write("\n");
+        // Show details for dimensions that aren't perfect
+        for (const dim of score.dimensions) {
+            if (dim.score < 100 && dim.details.length > 0) {
+                process.stdout.write(`  ${c(ANSI.dim, dim.name + ":")}\n`);
+                for (const detail of dim.details) {
+                    process.stdout.write(`    ${c(ANSI.dim, "→")} ${detail}\n`);
+                }
+            }
+        }
+        process.stdout.write("\n");
+        if (artifact.gate === "fail") {
+            process.exitCode = 1;
+        }
+    });
+    // ── badge ───────────────────────────────────────────────────────────
+    program
+        .command("badge")
+        .passThroughOptions()
+        .description("Generate an SVG health score badge for your README.")
+        .argument("<command...>", "Server command and arguments to run.")
+        .option("--output <file>", "Write SVG to file (default: stdout).")
+        .option("--label <text>", "Badge label text.", "MCP Health")
+        .action(async (commandArgs, options) => {
+        const target = targetFromCommand(commandArgs);
+        process.stderr.write(`${c(ANSI.dim, "⟳")} Scoring ${c(ANSI.bold, target.targetId)}...\n`);
+        const artifact = await runTarget(target, { invokeTools: true, securityCheck: true });
+        const score = artifact.healthScore;
+        if (!score) {
+            process.stderr.write("  Could not compute health score.\n");
+            process.exitCode = 1;
+            return;
+        }
+        const svg = generateBadgeSvg({ score: score.overall, grade: score.grade, label: options.label });
+        if (options.output) {
+            await mkdir(path.dirname(options.output), { recursive: true });
+            await writeFile(options.output, svg, "utf8");
+            process.stderr.write(`  Badge written to ${options.output}\n`);
+        }
+        else {
+            process.stdout.write(svg);
+        }
+    });
+}
+//# sourceMappingURL=score.js.map

package/dist/src/commands/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../../src/commands/score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,SAAS,EACT,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAErF,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,wEAAwE;IAExE,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,kBAAkB,EAAE;SACpB,WAAW,CAAC,uCAAuC,CAAC;SACpD,QAAQ,CAAC,cAAc,EAAE,sCAAsC,CAAC;SAChE,MAAM,CAAC,mBAAmB,EAAE,iDAAiD,EAAE,UAAU,CAAC;SAC1F,MAAM,CAAC,iBAAiB,EAAE,kCAAkC,CAAC;SAC7D,MAAM,CAAC,YAAY,EAAE,yBAAyB,CAAC;SAC/C,MAAM,CAAC,KAAK,EAAE,WAAqB,EAAE,OAA4C,EAAE,EAAE;QACpF,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5F,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrF,MAAM,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAEtE,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAuE,CAAC,CAAC;YACvH,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;YACxE,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM;gBACnC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAEb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC,UAAU,EAAE,GAAG,KAAK,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAEvI,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC;YAC1B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACzF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;YAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC;QACrJ,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3B,kDAAkD;QAClD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,KAAK,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC3D,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3B,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,uEAAuE;IAEvE,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,kBAAkB,EAAE;SACpB,WAAW,CAAC,qDAAqD,CAAC;SAClE,QAAQ,CAAC,cAAc,EAAE,sCAAsC,CAAC;SAChE,MAAM,CAAC,iBAAiB,EAAE,sCAAsC,CAAC;SACjE,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,WAAqB,EAAE,OAA2C,EAAE,EAAE;QACnF,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC1F,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAErF,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YAC5D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAEjG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/commands/serve.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerServeCommands(program: Command): void;

package/dist/src/commands/serve.js

@@ -0,0 +1,10 @@
+export function registerServeCommands(program) {
+    program
+        .command("serve")
+        .description("Start as an MCP server for AI agents.")
+        .action(async () => {
+        const { startServer } = await import("../server.js");
+        await startServer();
+    });
+}
+//# sourceMappingURL=serve.js.map

package/dist/src/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/serve.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/commands/suggest.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerSuggestCommands(program: Command): void;

package/dist/src/commands/suggest.js

@@ -0,0 +1,126 @@
+import { scanForTargets } from "../discovery.js";
+import { detectEnvironment } from "../environment.js";
+import { ANSI, c } from "./helpers.js";
+export function registerSuggestCommands(program) {
+    program
+        .command("suggest")
+        .description("Detect your stack and recommend MCP servers.")
+        .option("--cwd <path>", "Directory to scan for project signals.", process.cwd())
+        .option("--no-color", "Disable colored output.")
+        .action(async (options) => {
+        process.stdout.write(`${c(ANSI.dim, "⟳")} Scanning environment...\n\n`);
+        // 1. Current MCP servers
+        const targets = await scanForTargets();
+        if (targets.length > 0) {
+            process.stdout.write(c(ANSI.bold, "  Configured MCP Servers\n"));
+            for (const t of targets) {
+                const detail = t.config.adapter === "http"
+                    ? t.config.url
+                    : `${t.config.command} ${t.config.args.join(" ")}`;
+                process.stdout.write(`  ${c(ANSI.cyan, "●")} ${c(ANSI.bold, t.config.targetId)} ${c(ANSI.dim, detail)} ${c(ANSI.dim, `← ${t.source}`)}\n`);
+            }
+        }
+        else {
+            process.stdout.write(`  ${c(ANSI.yellow, "No MCP servers configured.")}\n`);
+        }
+        process.stdout.write("\n");
+        // 2. Environment detection
+        const env = await detectEnvironment(options.cwd);
+        const hasSignals = env.languages.length > 0 || env.frameworks.length > 0 || env.databases.length > 0;
+        if (hasSignals) {
+            process.stdout.write(c(ANSI.bold, "  Detected Stack\n"));
+            if (env.languages.length > 0)
+                process.stdout.write(`  ${c(ANSI.dim, "Languages:")}  ${env.languages.join(", ")}\n`);
+            if (env.frameworks.length > 0)
+                process.stdout.write(`  ${c(ANSI.dim, "Frameworks:")} ${env.frameworks.join(", ")}\n`);
+            if (env.databases.length > 0)
+                process.stdout.write(`  ${c(ANSI.dim, "Databases:")}  ${env.databases.join(", ")}\n`);
+            if (env.cloud.length > 0)
+                process.stdout.write(`  ${c(ANSI.dim, "Cloud:")}      ${env.cloud.join(", ")}\n`);
+            if (env.cicd.length > 0)
+                process.stdout.write(`  ${c(ANSI.dim, "CI/CD:")}      ${env.cicd.join(", ")}\n`);
+            if (env.services.length > 0)
+                process.stdout.write(`  ${c(ANSI.dim, "Services:")}   ${env.services.join(", ")}\n`);
+        }
+        else {
+            process.stdout.write(`  ${c(ANSI.dim, "No recognizable project signals in")} ${options.cwd}\n`);
+        }
+        process.stdout.write("\n");
+        // 3. MCP Registry — filtered by detected stack
+        try {
+            const response = await fetch("https://registry.modelcontextprotocol.io/v0/servers", {
+                signal: AbortSignal.timeout(10_000),
+                headers: { "Accept": "application/json" },
+            });
+            if (response.ok) {
+                const data = await response.json();
+                const raw = Array.isArray(data) ? data : (typeof data === "object" && data !== null
+                    ? (data["servers"] ?? data["results"] ?? data["items"])
+                    : null);
+                if (Array.isArray(raw)) {
+                    const allEntries = raw;
+                    // Build keyword set from detected environment
+                    const keywords = new Set([
+                        ...env.languages, ...env.frameworks, ...env.databases,
+                        ...env.services, ...env.cloud, ...env.cicd,
+                    ].map(s => s.toLowerCase()));
+                    // Also add common aliases
+                    const aliases = {
+                        typescript: ["ts"], javascript: ["js", "node"], python: ["py"],
+                        postgresql: ["postgres"], mongodb: ["mongo"], github: ["gh"],
+                    };
+                    for (const kw of [...keywords]) {
+                        for (const [full, abbrs] of Object.entries(aliases)) {
+                            if (kw === full)
+                                for (const a of abbrs)
+                                    keywords.add(a);
+                            if (abbrs.includes(kw))
+                                keywords.add(full);
+                        }
+                    }
+                    // Score each entry against detected stack
+                    const scored = allEntries.map(entry => {
+                        const srv = (typeof entry["server"] === "object" && entry["server"] !== null ? entry["server"] : entry);
+                        const name = typeof srv["name"] === "string" ? srv["name"] : (typeof entry["name"] === "string" ? entry["name"] : "unknown");
+                        const desc = typeof srv["description"] === "string" ? srv["description"] : (typeof entry["description"] === "string" ? entry["description"] : "");
+                        const text = `${name} ${desc}`.toLowerCase();
+                        const matches = [...keywords].filter(k => text.includes(k)).length;
+                        return { name, desc, matches };
+                    });
+                    const recommended = scored.filter(s => s.matches > 0).sort((a, b) => b.matches - a.matches);
+                    const others = scored.filter(s => s.matches === 0);
+                    if (recommended.length > 0) {
+                        process.stdout.write(c(ANSI.bold, "  Recommended for Your Stack\n"));
+                        for (const r of recommended.slice(0, 10)) {
+                            process.stdout.write(`  ${c(ANSI.green, "★")} ${c(ANSI.bold, r.name)}${r.desc ? ` ${c(ANSI.dim, "—")} ${r.desc}` : ""}\n`);
+                        }
+                        if (recommended.length > 10) {
+                            process.stdout.write(`  ${c(ANSI.dim, `... and ${recommended.length - 10} more matches`)}\n`);
+                        }
+                    }
+                    else {
+                        process.stdout.write(c(ANSI.bold, "  MCP Registry\n"));
+                        for (const s of scored.slice(0, 10)) {
+                            process.stdout.write(`  ${c(ANSI.dim, "●")} ${c(ANSI.bold, s.name)}${s.desc ? ` ${c(ANSI.dim, "—")} ${s.desc}` : ""}\n`);
+                        }
+                    }
+                    if (others.length > 0) {
+                        process.stdout.write(`\n  ${c(ANSI.dim, `${others.length} more servers at registry.modelcontextprotocol.io`)}\n`);
+                    }
+                }
+                else {
+                    process.stdout.write(`  ${c(ANSI.dim, "Registry returned unexpected format.")}\n`);
+                }
+            }
+            else {
+                process.stdout.write(`  ${c(ANSI.dim, `Registry returned HTTP ${response.status}`)}\n`);
+            }
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            process.stdout.write(`  ${c(ANSI.yellow, "Could not reach registry:")} ${msg}\n`);
+        }
+        process.stdout.write("\n");
+    });
+}
+//# sourceMappingURL=suggest.js.map