docs: document Windows stdio subprocess stdin handling
Merged
AN
4mo ago+59+59+01234567890123456789-0-0-0123456789
Summary
- document the Windows stdio subprocess hang when a child inherits the server stdin pipe
- show
stdin=subprocess.DEVNULLforasyncio.create_subprocess_exec - add a troubleshooting entry and link to it from the stdio run docs
Addresses #671.
Validation
- Reproduced the issue on Windows current
main: a v2MCPServerstdio tool that startssys.executable -c "print('Successfully Call!')"without redirecting stdin timed out/faulted after about 7.8s. - Confirmed the same repro succeeds in about 3.4s with
stdin=subprocess.DEVNULL. py -3.13 -m uv run --frozen mkdocs build --strict
AI disclosure
AI assistance was used while preparing this PR. I reviewed the final change, ran the validation listed above, and take responsibility for it.