Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 18 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,24 @@ Additional examples of using the Claude Desktop as an MCP client might look like
}
```

On Windows, apply the same wrapper to each `npx`-based entry above by changing `"command"` to `"cmd"` and prepending `"/c", "npx"` to the existing `args`. Leave `uvx` entries unchanged.
On Windows, apply the same wrapper to each `npx`-based entry above by changing `"command"` to `"cmd"` and prepending `"/c", "npx"` to the existing `args`. Keep `npx` in `args` instead of setting `"command"` to the full `npx.cmd` path; this avoids command-path parsing failures when Node.js is installed under `C:\Program Files\nodejs`.

If you need to use the absolute `npx.cmd` path, quote the executable for `cmd`:

```json
{
"command": "cmd",
"args": [
"/c",
"\"C:\\Program Files\\nodejs\\npx.cmd\"",
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\\Users\\username\\Desktop"
]
}
```

Leave interactive `uvx` entries unchanged. If a Windows scheduled task or logon-started client fails to launch a `uvx` server from a WinGet shim path such as `%LOCALAPPDATA%\Microsoft\WinGet\Links\uvx.exe`, point `"command"` at the real `uvx.exe` in the WinGet package directory, or install `uv` with an installer that places a normal executable on `PATH`.

## 🛠️ Creating Your Own Server

Expand Down
2 changes: 1 addition & 1 deletion src/filesystem/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -255,7 +255,7 @@ Note: all directories must be mounted to `/projects` by default.
}
```

On Windows, use `cmd /c` to launch `npx`:
On Windows, use `cmd /c` to launch `npx`. Keep `npx` in the `args` list as shown below when Node.js is installed in the default `C:\Program Files\nodejs` directory:

```json
{
Expand Down
6 changes: 6 additions & 0 deletions src/git/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,12 @@ Add this to your `claude_desktop_config.json`:
<details>
<summary>Using uvx</summary>

On Windows, if this server is launched by a scheduled task at logon and `uvx`
was installed by WinGet, avoid pointing the task at the WinGet shim under
`%LOCALAPPDATA%\Microsoft\WinGet\Links`. Use the real `uvx.exe` in the WinGet
package directory, or install `uv` with an installer that places a normal
executable on `PATH`.

```json
"mcpServers": {
"git": {
Expand Down
Loading