Title: stdio_client crashes on malformed UTF-8 from child stdout instead of surfacing parse error · Issue #2454 · modelcontextprotocol/python-sdk · GitHub
Open Graph Title: stdio_client crashes on malformed UTF-8 from child stdout instead of surfacing parse error · Issue #2454 · modelcontextprotocol/python-sdk
X Title: stdio_client crashes on malformed UTF-8 from child stdout instead of surfacing parse error · Issue #2454 · modelcontextprotocol/python-sdk
Description: Summary mcp.client.stdio.stdio_client() crashes when the spawned child process writes invalid UTF-8 bytes to stdout. The transport currently decodes child stdout with encoding_error_handler="strict", so malformed bytes raise during TextR...
Open Graph Description: Summary mcp.client.stdio.stdio_client() crashes when the spawned child process writes invalid UTF-8 bytes to stdout. The transport currently decodes child stdout with encoding_error_handler="strict...
X Description: Summary mcp.client.stdio.stdio_client() crashes when the spawned child process writes invalid UTF-8 bytes to stdout. The transport currently decodes child stdout with encoding_error_handler="s...
Opengraph URL: https://github.com/modelcontextprotocol/python-sdk/issues/2454
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"stdio_client crashes on malformed UTF-8 from child stdout instead of surfacing parse error","articleBody":"## Summary\n\n`mcp.client.stdio.stdio_client()` crashes when the spawned child process writes invalid UTF-8 bytes to stdout.\n\nThe transport currently decodes child stdout with `encoding_error_handler=\"strict\"`, so malformed bytes raise during `TextReceiveStream(...)` iteration. That exception escapes the decoding loop and brings down the transport task group instead of surfacing the bad line as an in-stream parse error.\n\n## Why this looks like a bug\n\nThe SDK already hardened the server side for the analogous case in PR #2302 (`fix: handle non-UTF-8 bytes in stdio server stdin`). That change explicitly preferred:\n\n- replace invalid bytes with U+FFFD,\n- let JSON validation fail on the malformed line, and\n- keep the transport alive so subsequent valid messages can still be processed.\n\nThe client side still behaves asymmetrically today. A buggy or non-compliant child server can kill the Python client transport with a single malformed line even if the next line is valid JSON-RPC.\n\nThat seems inconsistent with the current stdio robustness direction.\n\n## Reproduction\n\nA minimal child process that writes one malformed line and then one valid JSON-RPC line:\n\n```python\nimport sys\nimport time\n\nsys.stdout.buffer.write(b\"\\xff\\xfe\\n\")\nsys.stdout.buffer.write(b'{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"ping\"}\\n')\nsys.stdout.buffer.flush()\ntime.sleep(0.2)\n```\n\nWith current `stdio_client(...)` defaults, the transport raises `ExceptionGroup` instead of continuing.\n\n## Expected behavior\n\nThe malformed line should be surfaced as an in-stream parse / validation error, and the next valid JSON-RPC line should still be received.\n\n## Observed behavior\n\nThe transport task group fails before the valid follow-up message is delivered.\n\n## Proposed fix\n\nMatch the server-side approach from PR #2302:\n\n1. default `StdioServerParameters.encoding_error_handler` to `\"replace\"`\n2. continue treating malformed decoded lines as JSON validation failures\n3. keep the background stdio tasks resilient during early subprocess shutdown / abrupt close\n\n## Validation\n\nI reproduced this locally against current `main` and verified that a minimal patch plus a regression test fixes it.\n\nA focused regression test in `tests/client/test_stdio.py` can assert:\n\n- first item from the read stream is an `Exception`\n- second item is the valid `SessionMessage`\n","author":{"url":"https://github.com/shaun0927","@type":"Person","name":"shaun0927"},"datePublished":"2026-04-16T15:37:25.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/2454/python-sdk/issues/2454"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:d3541176-caf9-3c95-153c-dd54f7db5618 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 9EFA:2C4572:6FD75:949AA:6A5BB7D0 |
| html-safe-nonce | db0aae578542e07a24034dbe05c43d87f1819613e52cb975e408e1a994ab3424 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5RUZBOjJDNDU3Mjo2RkQ3NTo5NDlBQTo2QTVCQjdEMCIsInZpc2l0b3JfaWQiOiIyMjQzODk2MDcwNjIyNjU2NDY0IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | a014addbed6ea2bec4ee374fb5ab133faff1e5ebab4eab7f9298ee3692528b10 |
| hovercard-subject-tag | issue:4276797834 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/modelcontextprotocol/python-sdk/2454/issue_layout |
| twitter:image | https://opengraph.githubassets.com/935880e455b09b8455f653d76a391aaad686bb1ef6818c5d079a85d7443b72e6/modelcontextprotocol/python-sdk/issues/2454 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/935880e455b09b8455f653d76a391aaad686bb1ef6818c5d079a85d7443b72e6/modelcontextprotocol/python-sdk/issues/2454 |
| og:image:alt | Summary mcp.client.stdio.stdio_client() crashes when the spawned child process writes invalid UTF-8 bytes to stdout. The transport currently decodes child stdout with encoding_error_handler="strict... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | shaun0927 |
| hostname | github.com |
| expected-hostname | github.com |
| None | 5290d7e14309ad1e76106a9c4237bd1041517e83ea182c8ab756752cb0c6940b |
| turbo-cache-control | no-preview |
| go-import | github.com/modelcontextprotocol/python-sdk git https://github.com/modelcontextprotocol/python-sdk.git |
| octolytics-dimension-user_id | 182288589 |
| octolytics-dimension-user_login | modelcontextprotocol |
| octolytics-dimension-repository_id | 862584018 |
| octolytics-dimension-repository_nwo | modelcontextprotocol/python-sdk |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 862584018 |
| octolytics-dimension-repository_network_root_nwo | modelcontextprotocol/python-sdk |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 9c975978430e9ad293956f2bbdaf153b1bd84a99 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width