From 5f8353d8e764795be72f25087dc3d8bf14100e1b Mon Sep 17 00:00:00 2001
From: Flocky <flocky@silhouette.ai>
Date: Thu, 5 Mar 2026 15:39:10 +0000
Subject: [PATCH] docs(filesystem): add Windows npx cmd /c wrapper note

On Windows, npx is installed as npx.cmd which cannot be executed
directly by Node.js child_process.spawn(). This adds a note with
the cmd /c wrapper configuration for Windows users.

Fixes #3460
---
 src/filesystem/README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/src/filesystem/README.md b/src/filesystem/README.md
index bf087a2b25..622dc1eeba 100644
--- a/src/filesystem/README.md
+++ b/src/filesystem/README.md
@@ -250,6 +250,18 @@ Note: all directories must be mounted to `/projects` by default.
 }
 ```
 
+> **Windows users:** On Windows, npx is installed as `npx.cmd`. Use the `cmd /c` wrapper:
+> ```json
+> {
+>   "mcpServers": {
+>     "filesystem": {
+>       "command": "cmd",
+>       "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\username\\Desktop"]
+>     }
+>   }
+> }
+> ```
+
 ## Usage with VS Code
 
 For quick installation, click the installation buttons below...
@@ -308,6 +320,18 @@ Note: all directories must be mounted to `/projects` by default.
 }
 ```
 
+> **Windows users:** On Windows, npx is installed as `npx.cmd`. Use the `cmd /c` wrapper:
+> ```json
+> {
+>   "servers": {
+>     "filesystem": {
+>       "command": "cmd",
+>       "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
+>     }
+>   }
+> }
+> ```
+
 ## Build
 
 Docker build: