mcp2win

1# mcp2win
2 
3Finally, MCP servers & commands that just work on Windows.
4 
5Every MCP server README assumes macOS or Linux. You copy the config, paste it in, and nothing happens — because `npx`, `uvx`, and friends are `.cmd` batch shims on Windows, not real executables. `mcp2win` fixes this by wrapping commands with `cmd.exe /c` so your MCP servers actually start.
6 
7Works with **Claude Code/Desktop**, **VS Code**, **Cursor**, **Zed**, **Amazon Q**, and **Gemini CLI**
8 
9Copy any install command, prefix with `mcp2win`, confirm — done. Or convert online at [mcp2win.sh](https://mcp2win.sh).
10 
11## Quick start
12 
13No install needed — just run with `npx`:
14 
15```bash
16# Copy an MCP server's install command, prefix with mcp2win — confirm and it runs
17npx @operatorkit/mcp2win claude mcp add github-server -- npx -y @modelcontextprotocol/server-github
18# Shows the converted command, asks to confirm, then runs it
19 
20# Fix a config file (confirms before writing, creates .bak backup)
21npx @operatorkit/mcp2win claude_desktop_config.json
22 
23# Convert inline JSON (outputs to stdout, no confirmation needed)
24npx @operatorkit/mcp2win '{"command":"npx","args":["-y","@pkg"]}'
25```
26 
27## Install
28 
29If you use it often, install globally:
30 
31```bash
32npm i -g @operatorkit/mcp2win
33 
34# or with go
35go install github.com/operator-kit/mcp2win/cmd/mcp2win@latest
36 
37# or download a binary from https://github.com/operator-kit/mcp2win/releases
38```
39 
40## Usage
41 
42### CLI command translation
43 
44Paste any provider's `mcp add` command — `mcp2win` converts it and **runs it after confirmation**:
45 
46```bash
47# Claude — converts to add-json, confirms, runs
48mcp2win claude mcp add github-server -- npx -y @modelcontextprotocol/server-github
49# Execute? [y]es / [n]o / [a]lways: y
50 
51# VS Code
52mcp2win code --add-mcp '{"name":"my-server","command":"npx","args":["-y","@pkg"]}'
53 
54# Amazon Q
55mcp2win qchat mcp add -- npx -y @pkg
56 
57# Gemini
58mcp2win gemini mcp add fetch-server -- npx -y @pkg
59 
60# Skip confirmation (non-interactive / CI)
61mcp2win -y claude mcp add github-server -- npx -y @modelcontextprotocol/server-github
62 
63# Preview only, don't run
64mcp2win --dry-run claude mcp add github-server -- npx -y @modelcontextprotocol/server-github
65```
66 
67Answering **always** saves your preference — no more prompts for future CLI commands.
68 
69### File transformation
70 
71```bash
72# Preview + confirm write (creates .bak backup)
73mcp2win claude_desktop_config.json
74# Write changes to claude_desktop_config.json? [y]es / [n]o / [a]lways: y
75 
76# Skip confirmation
77mcp2win -y claude_desktop_config.json
78 
79# Write without backup
80mcp2win -y --no-backup claude_desktop_config.json
81 
82# Write to a different file
83mcp2win -y -o windows_config.json claude_desktop_config.json
84 
85# Preview only
86mcp2win --dry-run claude_desktop_config.json
87```
88 
89### JSON conversion
90 
91Transform inline JSON or pipe from stdin (outputs to stdout, no confirmation):
92 
93```bash
94# Inline
95mcp2win '{"command":"npx","args":["-y","@modelcontextprotocol/server-github"]}'
96 
97# Stdin
98cat claude_desktop_config.json | mcp2win
99 
100# Full config
101mcp2win '{"mcpServers":{"s1":{"command":"npx","args":["-y","@pkg"]}}}'
102```
103 
104### Updating
105 
106mcp2win checks for updates in the background and notifies you when a new version is available. To update:
107 
108```bash
109mcp2win update
110```
111 
112Disable background checks with `MCP2WIN_NO_UPDATE_CHECK=1`.
113 
114### Preferences
115 
116When you answer **always** at a prompt, the preference is saved. You can also manage preferences directly:
117 
118```bash
119mcp2win config get                              # show all preferences
120mcp2win config set always_exec_cli true         # skip CLI confirmation
121mcp2win config set always_write_file true       # skip file confirmation
122mcp2win config reset                            # reset all preferences
123mcp2win config path                             # show config file location
124```
125 
126## Flags
127 
128| Flag | Description |
129|---|---|
130| `--yes`, `-y` | Skip confirmation prompt (non-interactive mode) |
131| `--dry-run` | Preview only, no action |
132| `--quiet` | Suppress preview output |
133| `--no-backup` | Skip `.bak` backup when writing files |
134| `-o <path>` | Write output to a different file |
135| `--unwrap` | Reverse: remove `cmd.exe /c` wrapping |
136| `--resolve` | Resolve commands to absolute paths via `PATH`/`PATHEXT` |
137| `--no-color` | Disable colored output |
138 
139## What it does
140 
141- Wraps `.cmd` shim commands (`npx`, `uvx`, `pnpx`, `bunx`, `yarn`, `tsx`, etc.) with `cmd.exe /c`
142- Skips native executables (`node`, `python`, `deno`, `bun`)
143- Skips HTTP/SSE transport servers
144- Skips already-wrapped commands (idempotent)
145- Handles Zed's nested command format
146- Preserves all extra fields (`env`, `disabled`, etc.)
147- Supports Claude, VS Code, Cursor, Zed, Amazon Q, and Gemini configs
148 
149## License
150 
151MIT
152