mcp-proxy 6.1.8 → 6.1.9

package/README.md

@@ -21,6 +21,16 @@ npm install mcp-proxy
 
 ### Command-line
 
+MCP Proxy supports two invocation patterns:
+
+**Simple usage (no mcp-proxy options):**
+
+```bash
+npx mcp-proxy npx -y @anthropic/mcp-server-filesystem /path
+```
+
+**With mcp-proxy options:**
+
 ```bash
 npx mcp-proxy --port 8080 --shell -- tsx server.js
 ```
@@ -28,7 +38,11 @@ npx mcp-proxy --port 8080 --shell -- tsx server.js
 This starts a server and `stdio` server (`tsx server.js`). The server listens on port 8080 and `/mcp` (streamable HTTP) and `/sse` (SSE) endpoints, and forwards messages to the `stdio` server.
 
 > [!NOTE]
-> The `--` separator is required to separate mcp-proxy options from the command being proxied.
+> **About the `--` separator:**
+> - The `--` separator is **optional** when you don't need to pass options to mcp-proxy
+> - Use `--` when you need to pass options to mcp-proxy (like `--port`, `--shell`, etc.) to clearly separate them from the command
+> - Without `--`, the first positional argument is treated as the command, and all subsequent arguments are passed to that command
+> - The `--` separator is also useful when the command itself has flags that might conflict with mcp-proxy options
 
 options:
 

package/dist/bin/mcp-proxy.mjs

@@ -5012,7 +5012,14 @@ var StdioClientTransport = class {
 //#region src/bin/mcp-proxy.ts
 util.inspect.defaultOptions.depth = 8;
 if (!("EventSource" in global)) global.EventSource = EventSource;
-const argv = await yargs_default(hideBin(process.argv)).scriptName("mcp-proxy").usage("$0 [options] -- <command> [args...]").env("MCP_PROXY").parserConfiguration({ "populate--": true }).options({
+const argv = await yargs_default(hideBin(process.argv)).scriptName("mcp-proxy").command("$0 [command] [args...]", "Proxy an MCP stdio server over HTTP").positional("command", {
+	describe: "The command to run",
+	type: "string"
+}).positional("args", {
+	array: true,
+	describe: "The arguments to pass to the command",
+	type: "string"
+}).usage("$0 [options] -- <command> [args...]\n       $0 <command> [args...]").env("MCP_PROXY").parserConfiguration({ "populate--": true }).options({
 	apiKey: {
 		describe: "API key for authenticating requests (uses X-API-Key header)",
 		type: "string"
@@ -5085,14 +5092,22 @@ const argv = await yargs_default(hideBin(process.argv)).scriptName("mcp-proxy").
 	}
 }).help().parseAsync();
 const dashDashArgs = argv["--"];
-if (!dashDashArgs || dashDashArgs.length === 0) {
+let finalCommand;
+let finalArgs;
+if (dashDashArgs && dashDashArgs.length > 0) [finalCommand, ...finalArgs] = dashDashArgs;
+else if (argv.command) {
+	finalCommand = argv.command;
+	finalArgs = argv.args || [];
+} else {
 	console.error("Error: No command specified.");
 	console.error("Usage: mcp-proxy [options] -- <command> [args...]");
+	console.error("   or: mcp-proxy <command> [args...]");
 	console.error("");
-	console.error("Example: mcp-proxy --port 8080 -- node server.js --port 3000");
+	console.error("Examples:");
+	console.error("  mcp-proxy --port 8080 -- node server.js --port 3000");
+	console.error("  mcp-proxy node server.js");
 	process.exit(1);
 }
-const [finalCommand, ...finalArgs] = dashDashArgs;
 const connect = async (client) => {
 	const transport = new StdioClientTransport({
 		args: finalArgs,