@stealthmole/mcp 0.1.14 → 0.1.15

package/README.md

@@ -6,13 +6,15 @@ Connect [Claude Desktop](https://claude.ai/download), [Claude Code](https://docs
 
 ### All MCP clients at once
 
-Register StealthMole in every MCP client installed on this machine (Claude Desktop, Claude Code, Cursor, Codex, VS Code, Windsurf, and more):
+Register StealthMole in the MCP clients installed on this machine (Claude Desktop, Claude Code, Cursor, Codex, VS Code, Windsurf, and more):
 
 ```bash
 npx -y @stealthmole/mcp install
 ```
 
-Pick clients with `-a` (repeatable), e.g. `npx -y @stealthmole/mcp install -a cursor -a codex`. Run `npx -y @stealthmole/mcp install --help` for the full client list. A client that already runs StealthMole is left unchanged, so running it again is safe. Restart your clients afterwards.
+A checklist of the detected clients appears, all checked: press Space to uncheck a client, Enter to register. Without a terminal (scripts, CI), every detected client is registered.
+
+Or name clients with `-a` (repeatable) to skip the checklist, e.g. `npx -y @stealthmole/mcp install -a cursor -a codex`. Run `npx -y @stealthmole/mcp install --help` for the full client list. A client that already runs StealthMole is left unchanged, so running it again is safe. Restart your clients afterwards.
 
 ### Claude Desktop
 

package/bin/install.mjs

@@ -1,16 +1,19 @@
 // `npx -y @stealthmole/mcp install [-a <agent>]...` — register this server in
-// every MCP client on the machine (Claude Desktop, Claude Code, Cursor, Codex, …)
+// the MCP clients on the machine (Claude Desktop, Claude Code, Cursor, Codex, …)
 // through add-mcp's library, which knows each client's config path and format.
 //
-//   chosen agents ──▶ listInstalledServers ──┬─ already launches us ─▶ skip
-//   (-a, or all detected)                    └─ not yet ─────────────▶ upsertServer
+//   -a given ─────────────────────────────┐
+//   terminal: detected ─▶ checkbox pick ──┼─▶ listInstalledServers ──┬─ already launches us ─▶ skip
+//   no terminal: all detected ────────────┘                          └─ not yet ─────────────▶ upsertServer
 //
 // Skipping is the point: add-mcp's own CLI overwrites a same-named entry (the
 // customer's `env` is lost) and adds a second one under a new name (every tool
 // shows up twice). Identity is the package an entry launches, as in
 // claude-desktop-config.mjs.
 
+import { multiselect } from "@clack/prompts";
 import {
+  agents,
   detectGlobalAgents,
   getAgentTypes,
   listInstalledServers,
@@ -24,8 +27,9 @@ const AGENT_FLAGS = new Set(["-a", "--agent"]);
 
 const USAGE =
   "Usage: npx -y @stealthmole/mcp install [-a <agent>]...\n" +
-  "\nRegisters StealthMole MCP in every detected MCP client, or only in the\n" +
-  "clients named with -a. Clients that already run it are left unchanged.\n" +
+  "\nRegisters StealthMole MCP in the clients named with -a. Without -a, a\n" +
+  "terminal asks which detected clients to use; otherwise all are used.\n" +
+  "Clients that already run it are left unchanged.\n" +
   `\nAgents: ${getAgentTypes().join(", ")}\n`;
 
 /**
@@ -38,6 +42,43 @@ export function parseAgents(args) {
   return args.flatMap((arg, i) => (AGENT_FLAGS.has(arg) && args[i + 1] ? [args[i + 1]] : []));
 }
 
+/**
+ * Decide which agents to register in.
+ *
+ * @param {{
+ *   requested: string[],
+ *   detect: () => Promise<string[]>,
+ *   interactive: boolean,
+ *   pick: (detected: string[]) => Promise<string[] | symbol>,
+ * }} options
+ * @returns {Promise<string[] | null>} agents; [] when none detected, null when the user picked none
+ */
+export async function chooseTargets({ requested, detect, interactive, pick }) {
+  if (requested.length) return requested;
+  const detected = await detect();
+  // ponytail: no terminal keeps 0.1.14's register-all so scripted runs don't break.
+  if (!interactive || !detected.length) return detected;
+  const picked = await pick(detected);
+  // A non-array is clack's cancel symbol (Ctrl+C / Esc).
+  return Array.isArray(picked) && picked.length ? picked : null;
+}
+
+/**
+ * Checkbox prompt over the detected agents, all pre-checked so Enter keeps
+ * the old "every client" result.
+ *
+ * @param {string[]} detected agent types
+ * @returns {Promise<string[] | symbol>} picked agent types, or clack's cancel symbol
+ */
+function pickAgents(detected) {
+  return multiselect({
+    message: "Register StealthMole MCP in (space: toggle, enter: confirm)",
+    options: detected.map((type) => ({ value: type, label: agents[type].displayName })),
+    initialValues: detected,
+    required: false,
+  });
+}
+
 /**
  * Register this server in each chosen agent's global config.
  *
@@ -58,7 +99,16 @@ export async function install({ pkgVersion, args }) {
     return 1;
   }
 
-  const targets = requested.length ? requested : await detectGlobalAgents();
+  const targets = await chooseTargets({
+    requested,
+    detect: detectGlobalAgents,
+    interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+    pick: pickAgents,
+  });
+  if (targets === null) {
+    console.error(`${LOG_PREFIX} Nothing selected; nothing registered.`);
+    return 0;
+  }
   if (!targets.length) {
     console.error(`${LOG_PREFIX} No MCP clients found. Name one with -a <agent>.\n\n${USAGE}`);
     return 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stealthmole/mcp",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "StealthMole Threat Intelligence MCP client - connect Claude Desktop, Cursor, and other MCP clients to StealthMole API",
   "bin": {
     "stealthmole-mcp": "bin/cli.mjs"
@@ -12,6 +12,7 @@
     "bin/"
   ],
   "dependencies": {
+    "@clack/prompts": "0.9.1",
     "add-mcp": "2.6.1",
     "mcp-remote": "0.15.1"
   },