mcp-cross 1.1.0 → 1.2.0-beta.1

package/README.md

@@ -404,6 +404,8 @@ GitHub MCP Server (api.githubcopilot.com)
 
 Use these tested command lines when mirroring Claude Desktop’s configuration. Each snippet lists every flag that must be present for the server to launch successfully under Windows → WSL bridging.
 
+> **Windows quoting fix:** Claude Desktop launches stdio servers through `cmd.exe`. When it resolves `command: "npx"` to `C:\Program Files\nodejs\npx.cmd` the resulting command line is emitted without quotes, leading to the classic `'C:\Program' is not recognized` failure. Wrap every `npx` invocation inside `powershell.exe -NoLogo -NoProfile -Command "& { ... }"` so PowerShell handles the quoting before `cmd.exe` runs it.
+
 #### 1. Ghostis Brain (Python + WSL)
 
 Requirements:
@@ -424,11 +426,12 @@ Claude config fragment:
 
 ```json
 "ghostis-brain": {
-  "command": "npx",
+  "command": "powershell.exe",
   "args": [
-    "-y", "mcp-cross@latest",
-    "--wsl", "--shell", "zsh",
-    "--", "python3", "-m", "ghostis.mcp"
+    "-NoLogo",
+    "-NoProfile",
+    "-Command",
+    "& { npx -y mcp-cross@latest --wsl --shell zsh -- python3 -m ghostis.mcp }"
   ],
   "env": {
     "GHOSTIS_STORAGE_DIR": "/home/epps/.ghostis/memory",
@@ -456,14 +459,12 @@ Claude config fragment:
 
 ```json
 "filesystem": {
-  "command": "npx",
+  "command": "powershell.exe",
   "args": [
-    "-y", "mcp-cross@latest",
-    "--wsl", "--shell", "zsh",
-    "--",
-    "npx", "-y", "@modelcontextprotocol/server-filesystem",
-    "C:\\Users\\seane\\dev",
-    "/mnt/dev/workspaces"
+    "-NoLogo",
+    "-NoProfile",
+    "-Command",
+    "& { npx -y mcp-cross@latest --wsl --shell zsh -- npx -y @modelcontextprotocol/server-filesystem C:\\Users\\seane\\dev /mnt/dev/workspaces }"
   ]
 }
 ```
@@ -487,18 +488,17 @@ Claude config fragment:
 
 ```json
 "github-mcp-server": {
-  "command": "npx",
+  "command": "powershell.exe",
   "args": [
-    "-y", "mcp-cross@latest",
-    "--debug",
-    "--wsl", "--shell", "zsh",
-    "--http", "https://api.githubcopilot.com/mcp/",
-    "--header", "Authorization: Bearer $GH_TOKEN"
+    "-NoLogo",
+    "-NoProfile",
+    "-Command",
+    "& { npx -y mcp-cross@latest --debug --wsl --shell zsh --http https://api.githubcopilot.com/mcp/ --header 'Authorization: Bearer $GH_TOKEN' }"
   ]
 }
 ```
 
-> **Tip:** When testing from Windows PowerShell, keep the `$GH_TOKEN` literal inside single quotes and pass the actual value with `--env GH_TOKEN=$env:GH_TOKEN` so the proxy can expand it inside WSL exactly like Claude does.
+> **Tip:** When using the PowerShell wrapper (either manually or via Claude), keep `$GH_TOKEN` inside single quotes and pass the actual value with `--env GH_TOKEN=$env:GH_TOKEN` so the proxy can expand it inside WSL exactly like Claude does.
 
 ### Bridge Usage
 
@@ -527,12 +527,12 @@ mcp-cross --wsl cat C:\data.txt
 {
   "mcpServers": {
     "wsl-server": {
-      "command": "npx",
+      "command": "powershell.exe",
       "args": [
-        "mcp-cross",
-        "--wsl",
-        "node",
-        "/home/user/server.js"
+        "-NoLogo",
+        "-NoProfile",
+        "-Command",
+        "& { npx -y mcp-cross@latest --wsl node /home/user/server.js }"
       ]
     }
   }
@@ -659,6 +659,24 @@ Check the debug output for:
 - Command resolution problems
 - Process spawning errors
 
+### `'C:\\Program' is not recognized`
+
+This happens when Claude Desktop (or any Windows host that shells through `cmd.exe`) resolves `command: "npx"` to `C:\Program Files\nodejs\npx.cmd` and runs it without surrounding quotes. Windows interprets everything up to the first space as the executable name, so `cmd.exe` tries to launch `C:\Program` and immediately fails.
+
+**Fix:** Wrap the entire `npx` invocation inside PowerShell so the quoting happens before `cmd.exe` ever sees the command line:
+
+```json
+"command": "powershell.exe",
+"args": [
+  "-NoLogo",
+  "-NoProfile",
+  "-Command",
+  "& { npx -y mcp-cross@latest --wsl --shell zsh -- ... }"
+]
+```
+
+All Claude Desktop examples in this README already use that wrapper. If you still prefer `command: "npx"`, move your Node.js installation to a path without spaces (or set `command` to a short path such as `C:\npx\npx.cmd`).
+
 ### Windows Executable Not Found in WSL
 
 Ensure:

package/examples/claude-desktop-http.json

@@ -2,37 +2,34 @@
   "mcpServers": {
     "github-mcp-via-wsl": {
       "type": "stdio",
-      "command": "npx",
+      "command": "powershell.exe",
       "args": [
-        "-y",
-        "mcp-cross@latest",
-        "--wsl",
-        "--http", "https://api.githubcopilot.com/mcp/",
-        "--header", "Authorization: Bearer $GH_TOKEN"
+        "-NoLogo",
+        "-NoProfile",
+        "-Command",
+        "& { npx -y mcp-cross@latest --wsl --http https://api.githubcopilot.com/mcp/ --header 'Authorization: Bearer $GH_TOKEN' }"
       ],
       "comment": "Access GitHub MCP server with token stored in WSL environment"
     },
     "custom-mcp-server": {
       "type": "stdio", 
-      "command": "npx",
+      "command": "powershell.exe",
       "args": [
-        "-y",
-        "mcp-cross@latest",
-        "--http", "https://api.example.com/mcp/",
-        "--header", "Authorization: Bearer $API_TOKEN",
-        "--header", "X-Tenant-ID: $TENANT_ID",
-        "--timeout", "30000"
+        "-NoLogo",
+        "-NoProfile",
+        "-Command",
+        "& { npx -y mcp-cross@latest --http https://api.example.com/mcp/ --header 'Authorization: Bearer $API_TOKEN' --header 'X-Tenant-ID: $TENANT_ID' --timeout 30000 }"
       ],
       "comment": "HTTP MCP server with multiple custom headers"
     },
     "local-debug": {
       "type": "stdio",
-      "command": "npx",
+      "command": "powershell.exe",
       "args": [
-        "-y",
-        "mcp-cross@latest",
-        "--debug",
-        "--http", "http://localhost:3000/mcp"
+        "-NoLogo",
+        "-NoProfile",
+        "-Command",
+        "& { npx -y mcp-cross@latest --debug --http http://localhost:3000/mcp }"
       ],
       "comment": "Local MCP server for debugging (HTTP allowed for localhost)"
     }

package/examples/claude-desktop-npx.json

@@ -1,48 +1,42 @@
 {
   "mcpServers": {
     "filesystem": {
-      "command": "npx",
+      "command": "powershell.exe",
       "args": [
-        "mcp-cross",
-        "--",
-        "npx",
-        "-y",
-        "@modelcontextprotocol/server-filesystem",
-        "/Users/username/Documents"
+        "-NoLogo",
+        "-NoProfile",
+        "-Command",
+        "& { npx -y mcp-cross@latest -- npx -y @modelcontextprotocol/server-filesystem /Users/username/Documents }"
       ]
     },
     "brave-search": {
-      "command": "npx",
+      "command": "powershell.exe",
       "args": [
-        "mcp-cross",
-        "--",
-        "npx",
-        "-y",
-        "@modelcontextprotocol/server-brave-search"
+        "-NoLogo",
+        "-NoProfile",
+        "-Command",
+        "& { npx -y mcp-cross@latest -- npx -y @modelcontextprotocol/server-brave-search }"
       ],
       "env": {
         "BRAVE_API_KEY": "your-api-key-here"
       }
     },
     "custom-nodejs-server": {
-      "command": "npx",
+      "command": "powershell.exe",
       "args": [
-        "mcp-cross",
-        "--",
-        "node",
-        "/path/to/your/server.js",
-        "--config",
-        "production"
+        "-NoLogo",
+        "-NoProfile",
+        "-Command",
+        "& { npx -y mcp-cross@latest -- node /path/to/your/server.js --config production }"
       ]
     },
     "with-debug": {
-      "command": "npx",
+      "command": "powershell.exe",
       "args": [
-        "mcp-cross",
-        "--debug",
-        "--",
-        "node",
-        "/path/to/server.js"
+        "-NoLogo",
+        "-NoProfile",
+        "-Command",
+        "& { npx -y mcp-cross@latest --debug -- node /path/to/server.js }"
       ]
     }
   }

package/index.js

@@ -10,6 +10,23 @@ const { platform } = require('os');
 const wslBridge = require('./src/lib/wsl-bridge');
 const { startHttpProxy } = require('./src/lib/http-proxy');
 
+function extractEnvVarsFromStrings(strings) {
+  if (!Array.isArray(strings)) return [];
+  const vars = new Set();
+  for (const value of strings) {
+    if (typeof value !== 'string') continue;
+    const regex = /\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-[^}]*)?\}|\$([A-Za-z_][A-Za-z0-9_]*)/g;
+    let match;
+    while ((match = regex.exec(value)) !== null) {
+      const name = match[1] || match[2];
+      if (name) {
+        vars.add(name);
+      }
+    }
+  }
+  return Array.from(vars);
+}
+
 /**
  * mcp-cross - Cross-platform MCP server bridge
  *
@@ -398,6 +415,17 @@ async function main() {
         wslArgs.push('--debug');
       }
 
+      if (mcpCrossOptions.includes('--debug')) {
+        const debugVars = extractEnvVarsFromStrings(httpHeaders);
+        if (debugVars.length > 0) {
+          const existing = customEnv.MCP_CROSS_DEBUG_VARS
+            ? customEnv.MCP_CROSS_DEBUG_VARS.split(',').map(v => v.trim()).filter(Boolean)
+            : [];
+          const merged = new Set([...existing, ...debugVars]);
+          customEnv.MCP_CROSS_DEBUG_VARS = Array.from(merged).join(',');
+        }
+      }
+
       try {
         await wslBridge.execute(wslCommand, wslArgs, mcpCrossOptions, customEnv);
       } catch (err) {
@@ -429,6 +457,16 @@ async function main() {
 
   // Check for WSL bridge mode (process bridge)
   if (mcpCrossOptions.includes('--wsl')) {
+    if (mcpCrossOptions.includes('--debug')) {
+      const debugVars = extractEnvVarsFromStrings([serverCommand, ...serverArgs]);
+      if (debugVars.length > 0) {
+        const existing = customEnv.MCP_CROSS_DEBUG_VARS
+          ? customEnv.MCP_CROSS_DEBUG_VARS.split(',').map(v => v.trim()).filter(Boolean)
+          : [];
+        const merged = new Set([...existing, ...debugVars]);
+        customEnv.MCP_CROSS_DEBUG_VARS = Array.from(merged).join(',');
+      }
+    }
     try {
       await wslBridge.execute(serverCommand, serverArgs, mcpCrossOptions, customEnv);
     } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-cross",
-  "version": "1.1.0",
+  "version": "1.2.0-beta.1",
   "description": "Cross-platform MCP server bridge for seamless stdio communication across different environments",
   "author": "Sean Epping",
   "license": "MIT",

package/src/scripts/wsl-runner.sh

@@ -33,6 +33,31 @@ fi
 if [ -n "${MCP_CROSS_DEBUG-}" ]; then
   echo "DEBUG: FILTERED PATH=" >&2
   printenv PATH >&2
+
+  if [ -n "${MCP_CROSS_DEBUG_VARS-}" ]; then
+    OLD_IFS_ENV="$IFS"
+    IFS=','
+    read -ra DEBUG_VARS <<< "$MCP_CROSS_DEBUG_VARS"
+    IFS="$OLD_IFS_ENV"
+
+    for rawVar in "${DEBUG_VARS[@]}"; do
+      var="$(echo "$rawVar" | xargs)"
+      if [ -z "$var" ]; then
+        continue
+      fi
+
+      if [ -z "${!var+x}" ]; then
+        echo "DEBUG: ENV[$var]=<unset>" >&2
+      else
+        value="${!var}"
+        if [ -z "$value" ]; then
+          echo "DEBUG: ENV[$var]=<empty>" >&2
+        else
+          echo "DEBUG: ENV[$var]=<set length=${#value}>" >&2
+        fi
+      fi
+    done
+  fi
 fi
 
 # Exec the provided command