run-mcp 1.3.4 → 1.5.0

package/README.md

@@ -40,6 +40,9 @@ run-mcp repl node path/to/my-mcp-server.js
 
 # Or use npx without installing globally
 npx . repl node path/to/my-mcp-server.js
+
+# Or start it without arguments to open the interactive server discovery menu!
+run-mcp
 ```
 
 You'll see an interactive prompt:
@@ -62,6 +65,7 @@ Options:
   -o, --out-dir <path>        Directory to save intercepted images and audio
   -t, --timeout <ms>          Default tool call timeout in milliseconds (default: 300000) (Agent Mode only)
       --max-text <chars>      Max text response length before truncation (default: 50000) (Agent Mode only)
+      --mcp                   Force start Agent Server mode even if run interactively without arguments
   -s, --script <file>         Read commands from a file instead of stdin (REPL Mode only)
   -h, --help                  Display help for command
 
@@ -100,16 +104,13 @@ Then use these tools from your agent:
 
 | Tool | Description |
 |------|-------------|
-| `connect_to_mcp` | Spawn and connect to a local MCP server |
+| `connect_to_mcp` | Spawn and connect to a local MCP server. Use `include` to get tools/resources/prompts inline. Shows a diff on reconnect. |
 | `disconnect_from_mcp` | Tear down the connection |
 | `mcp_server_status` | Check connection status |
-| `list_mcp_tools` | List tools on the connected server |
-| `call_mcp_tool` | Call a tool (with interception) |
-| `list_mcp_resources` | List resources |
-| `read_mcp_resource` | Read a resource by URI |
-| `list_mcp_prompts` | List prompts |
-| `get_mcp_prompt` | Get a prompt by name |
+| `call_mcp_primitive` | Call a tool, read a resource, or get a prompt. Auto-connects if not already connected. Use `disconnect_after` for one-shot tests. |
+| `list_mcp_primitives` | List tools, resources, and/or prompts on the connected server |
 | `get_mcp_server_stderr` | View target server stderr output |
+| `list_available_mcp_servers`| Discover other local MCP servers configured on the host machine |
 
 ## REPL Mode Commands
 
@@ -117,9 +118,11 @@ Once connected via `run-mcp <command>`, the following shorthand commands are ava
 
 | Command | Description |
 |---------|-------------|
+| `explore` | Open interactive fuzzy-search selector for tools, resources, and prompts |
 | `tools/list` | List all tools exposed by the target server |
 | `tools/describe <name>` | Show a tool's full input schema |
-| `tools/call <name> <json> [--timeout <ms>]` | Call a tool with JSON arguments |
+| `tools/call <name> [json] [--clear]` | Call a tool. Launch interactive wizard if no JSON provided. Use `--clear` to ignore remembered arguments. |
+| `tools/forget [name]` | Clear remembered interactive arguments for a tool, or all tools if no name provided. |
 | `status` | Show target server status (PID, uptime, connection) |
 | `help` | Show available commands |
 | `exit` / `quit` | Disconnect and exit |
@@ -141,6 +144,19 @@ Once connected via `run-mcp <command>`, the following shorthand commands are ava
 
 # Arguments with spaces work fine
 > tools/call send_message {"text": "hello world", "channel": "general"}
+
+### Interactive Wizard & Argument Memory
+
+If you invoke a tool without JSON arguments, `run-mcp` will guide you through an interactive scaffolding wizard:
+```bash
+> tools/call send_message
+✔ text (string) Message text to send: Hello World!
+✔ Select optional arguments to provide: channel
+✔ channel (string) The Slack channel: general
+✔ Execute? Yes
+  Calling send_message...
+```
+`run-mcp` actively **remembers** your inputs across identical interactive calls, scaffolding defaults based on your last execution! Use `tools/forget` or `--clear` if you need a clean slate.
 ```
 
 ### Script Mode
@@ -256,4 +272,4 @@ node dist/index.js repl <target_command...>
 
 ## License
 
-ISC
+MIT