run-mcp 1.6.1 → 1.6.3

package/README.md

@@ -5,7 +5,7 @@ A smart proxy, interactive REPL, and live test harness for [Model Context Protoc
 `run-mcp` operates in two modes:
 
 1. **Agent MCP Server** (`run-mcp`) — An MCP server that exposes tools (`connect_to_mcp`, `call_mcp_tool`) so AI agents can dynamically connect to and test local MCP projects without hardcoding them in configuration files. This is the **default mode** when you run `npx -y run-mcp`.
-2. **Interactive REPL** (`run-mcp repl`) — A headless CLI for human developers to manually test and explore MCP servers using short, memorable commands (`tools/call`, `status`, etc.).
+2. **Interactive REPL** (Interactive mode) — A headless CLI for human developers to manually test and explore MCP servers using short, memorable commands (`tools/call`, `status`, etc.).
 
 ### Interception Rules (Agent Server & REPL)
 
@@ -234,7 +234,7 @@ tools/call screenshot {"save_path": "/tmp/test.png"}
 ```
 
 ```bash
-run-mcp repl node my-server.js --script commands.txt
+run-mcp -s commands.txt -- node my-server.js
 ```
 
 - Lines starting with `#` are treated as comments
@@ -330,7 +330,7 @@ npm run build
 npm run dev
 
 # Run directly
-node dist/index.js repl <target_command...>
+node dist/index.js -- <target_command...>
 ```
 
 ## License

package/dist/index.js

@@ -921,7 +921,7 @@ var TargetManager = class _TargetManager extends EventEmitter {
         this.transport = stdioTransport;
       }
       this.client = new Client(
-        { name: "run-mcp", version: "1.6.1" },
+        { name: "run-mcp", version: "1.6.3" },
         {
           capabilities: {
             roots: { listChanged: true },
@@ -1620,6 +1620,7 @@ import { createInterface } from "readline";
 import { checkbox, confirm, input as input2, search } from "@inquirer/prompts";
 import pc2 from "picocolors";
 var KNOWN_COMMANDS = [
+  "menu",
   "explore",
   "interactive",
   "tools/list",
@@ -2078,7 +2079,7 @@ async function startRepl(targetCommand, opts) {
     await target.close();
     process.exit(0);
   } else {
-    startReadlineLoop(target, interceptor);
+    mainMenuLoop(target, interceptor);
   }
 }
 function startReadlineLoop(target, interceptor) {
@@ -2174,11 +2175,16 @@ async function handleCommand(input3, target, interceptor) {
     case "?":
       printShortHelp();
       return;
+    case "menu":
     case "explore":
     case "interactive":
-      await withSuspendedReadline(target, interceptor, async () => {
-        await cmdExplore(target, interceptor);
-      });
+      if (activeRl) {
+        globalPauseReadlineClose = true;
+        activeRl.close();
+        activeRl = null;
+        globalPauseReadlineClose = false;
+      }
+      mainMenuLoop(target, interceptor);
       return;
     case "tools/list":
       await cmdToolsList(target);
@@ -3299,7 +3305,7 @@ async function pickInteractive(items, message) {
     throw err;
   }
 }
-async function cmdExplore(target, interceptor) {
+async function showMainMenu(target, interceptor) {
   const choices = [];
   const caps = target.getServerCapabilities() ?? {};
   try {
@@ -3339,26 +3345,30 @@ async function cmdExplore(target, interceptor) {
     } catch {
     }
   }
-  if (choices.length === 0) {
-    console.log(pc2.yellow("No tools, resources, or prompts found."));
-    return;
-  }
-  if (!process.stdin.isTTY) {
-    console.log(pc2.bold("\n  Server Capabilities\n"));
-    for (let i = 0; i < choices.length; i++) {
-      console.log(
-        `  ${pc2.cyan(String(i + 1).padStart(2))}. ${choices[i].name}  ${pc2.dim(choices[i].description)}`
-      );
-    }
-    console.log();
-    console.log(
-      pc2.dim("  Non-interactive mode \u2014 use specific commands instead (e.g., tools/call <name>).")
-    );
-    return;
-  }
+  choices.push({
+    name: "\u2699\uFE0F  Check Server Status",
+    value: { type: "command", name: "status" },
+    description: "View connection status and server info"
+  });
+  choices.push({
+    name: "\u{1F504} Reconnect Server",
+    value: { type: "command", name: "reconnect" },
+    description: "Restart the target MCP server"
+  });
+  choices.push({
+    name: "\u2328\uFE0F  Type a raw command",
+    value: { type: "raw" },
+    description: "Drop to the traditional REPL prompt (use 'menu' to return)"
+  });
+  choices.push({
+    name: "\u{1F6AA} Exit",
+    value: { type: "command", name: "exit" },
+    description: "Close connection and exit"
+  });
+  if (!process.stdin.isTTY) return false;
   try {
     const answer = await search({
-      message: "Explore server capabilities:",
+      message: "Select an action (start typing to search):",
       source: async (term) => {
         if (!term) return choices;
         const lower = term.toLowerCase();
@@ -3373,10 +3383,46 @@ async function cmdExplore(target, interceptor) {
       await cmdResourcesRead(target, answer.uri);
     } else if (answer.type === "prompt") {
       await cmdPromptsGet(target, answer.name);
+    } else if (answer.type === "command") {
+      if (answer.name === "status") {
+        cmdStatus(target);
+      } else if (answer.name === "reconnect") {
+        await cmdReconnect(target);
+      } else if (answer.name === "exit") {
+        console.log(pc2.dim("\nShutting down..."));
+        await target.close();
+        process.exit(0);
+      }
+    } else if (answer.type === "raw") {
+      return true;
     }
+    return false;
   } catch (err) {
-    if (!isAbortError(err)) {
-      throw err;
+    if (isAbortError(err)) {
+      console.log(pc2.dim("\nShutting down..."));
+      await target.close();
+      process.exit(0);
+    }
+    throw err;
+  }
+}
+async function mainMenuLoop(target, interceptor) {
+  if (isScriptMode || !process.stdin.isTTY) {
+    startReadlineLoop(target, interceptor);
+    return;
+  }
+  while (true) {
+    try {
+      const dropToRaw = await showMainMenu(target, interceptor);
+      if (dropToRaw) {
+        console.log(pc2.dim("  Entering raw command mode. Type 'menu' to return."));
+        startReadlineLoop(target, interceptor);
+        break;
+      }
+    } catch (err) {
+      console.error(pc2.red(`Error in menu: ${err.message}`));
+      startReadlineLoop(target, interceptor);
+      break;
     }
   }
 }
@@ -3444,7 +3490,7 @@ async function startServer(opts) {
     mediaThresholdKb: opts.mediaThresholdKb
   });
   const mcpServer = new McpServer(
-    { name: "run-mcp", version: "1.6.1" },
+    { name: "run-mcp", version: "1.6.3" },
     {
       capabilities: {
         tools: {},
@@ -4732,7 +4778,7 @@ program.command("close-session").argument("<session_name>", "Session name").desc
     }
   }
 });
-program.name("run-mcp").description("A smart interactive REPL and live test harness for MCP servers").version("1.6.1").passThroughOptions().allowUnknownOption().argument(
+program.name("run-mcp").description("A smart interactive REPL and live test harness for MCP servers").version("1.6.3").passThroughOptions().allowUnknownOption().argument(
   "[target_command...]",
   "Command to spawn the target MCP server (starts REPL if provided, Agent server otherwise)"
 ).option("-o, --out-dir <path>", "Directory to save intercepted images and audio").option(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run-mcp",
-  "version": "1.6.1",
+  "version": "1.6.3",
   "description": "A smart proxy and interactive REPL for Model Context Protocol (MCP) servers",
   "homepage": "https://github.com/funkyfunc/run-mcp#readme",
   "bugs": {