Skip to content

docs(memory): add WSL2 troubleshooting for npx stdout JSON parse errors#3804

Open
ssam18 wants to merge 1 commit intomodelcontextprotocol:mainfrom
ssam18:docs/memory-wsl2-troubleshooting
Open

docs(memory): add WSL2 troubleshooting for npx stdout JSON parse errors#3804
ssam18 wants to merge 1 commit intomodelcontextprotocol:mainfrom
ssam18:docs/memory-wsl2-troubleshooting

Conversation

@ssam18
Copy link
Copy Markdown

@ssam18 ssam18 commented Apr 3, 2026

Running the memory server via npx in WSL2 causes JSON parse errors at a fixed byte offset because npx writes package resolution output to stdout, which corrupts the MCP stdio JSON-RPC stream. Added a troubleshooting section with two workarounds:

  1. global install
  2. direct node invocation

So users can get unblocked without needing to dig through issues..

…e errors

Explains why `npx -y @modelcontextprotocol/server-memory` causes
"Unexpected non-whitespace character after JSON at position 127" errors
in WSL2, and provides two workarounds: global npm install and direct
node invocation. Fixes modelcontextprotocol#3013.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant