René's URL Explorer Experiment


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

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@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-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:d3541176-caf9-3c95-153c-dd54f7db5618
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-id9EFA:2C4572:6FD75:949AA:6A5BB7D0
html-safe-noncedb0aae578542e07a24034dbe05c43d87f1819613e52cb975e408e1a994ab3424
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5RUZBOjJDNDU3Mjo2RkQ3NTo5NDlBQTo2QTVCQjdEMCIsInZpc2l0b3JfaWQiOiIyMjQzODk2MDcwNjIyNjU2NDY0IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmaca014addbed6ea2bec4ee374fb5ab133faff1e5ebab4eab7f9298ee3692528b10
hovercard-subject-tagissue:4276797834
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/modelcontextprotocol/python-sdk/2454/issue_layout
twitter:imagehttps://opengraph.githubassets.com/935880e455b09b8455f653d76a391aaad686bb1ef6818c5d079a85d7443b72e6/modelcontextprotocol/python-sdk/issues/2454
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/935880e455b09b8455f653d76a391aaad686bb1ef6818c5d079a85d7443b72e6/modelcontextprotocol/python-sdk/issues/2454
og:image:altSummary 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:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameshaun0927
hostnamegithub.com
expected-hostnamegithub.com
None5290d7e14309ad1e76106a9c4237bd1041517e83ea182c8ab756752cb0c6940b
turbo-cache-controlno-preview
go-importgithub.com/modelcontextprotocol/python-sdk git https://github.com/modelcontextprotocol/python-sdk.git
octolytics-dimension-user_id182288589
octolytics-dimension-user_loginmodelcontextprotocol
octolytics-dimension-repository_id862584018
octolytics-dimension-repository_nwomodelcontextprotocol/python-sdk
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id862584018
octolytics-dimension-repository_network_root_nwomodelcontextprotocol/python-sdk
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release9c975978430e9ad293956f2bbdaf153b1bd84a99
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/issues/2454#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2F2454
GitHub CopilotWrite better code with AIhttps://github.com/features/copilot
GitHub Copilot appDirect agents from issue to mergehttps://github.com/features/ai/github-app
MCP RegistryNewIntegrate external toolshttps://github.com/mcp
ActionsAutomate any workflowhttps://github.com/features/actions
CodespacesInstant dev environmentshttps://github.com/features/codespaces
IssuesPlan and track workhttps://github.com/features/issues
Code ReviewManage code changeshttps://github.com/features/code-review
GitHub Advanced SecurityFind and fix vulnerabilitieshttps://github.com/security/advanced-security
Code securitySecure your code as you buildhttps://github.com/security/advanced-security/code-security
Secret protectionStop leaks before they starthttps://github.com/security/advanced-security/secret-protection
Why GitHubhttps://github.com/why-github
Documentationhttps://docs.github.com
Bloghttps://github.blog
Changeloghttps://github.blog/changelog
Marketplacehttps://github.com/marketplace
View all featureshttps://github.com/features
Enterpriseshttps://github.com/enterprise
Small and medium teamshttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
App Modernizationhttps://github.com/solutions/use-case/app-modernization
DevSecOpshttps://github.com/solutions/use-case/devsecops
DevOpshttps://github.com/solutions/use-case/devops
CI/CDhttps://github.com/solutions/use-case/ci-cd
View all use caseshttps://github.com/solutions/use-case
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
View all industrieshttps://github.com/solutions/industry
View all solutionshttps://github.com/solutions
AIhttps://github.com/resources/articles?topic=ai
Software Developmenthttps://github.com/resources/articles?topic=software-development
DevOpshttps://github.com/resources/articles?topic=devops
Securityhttps://github.com/resources/articles?topic=security
View all topicshttps://github.com/resources/articles
Customer storieshttps://github.com/customer-stories
Events & webinarshttps://github.com/resources/events
Ebooks & reportshttps://github.com/resources/whitepapers
Business insightshttps://github.com/solutions/executive-insights
GitHub Skillshttps://skills.github.com
Documentationhttps://docs.github.com
Customer supporthttps://support.github.com
Community forumhttps://github.com/orgs/community/discussions
Trust centerhttps://github.com/trust-center
Partnershttps://github.com/partners
View all resourceshttps://github.com/resources
GitHub SponsorsFund open source developershttps://github.com/open-source/sponsors
Security Labhttps://securitylab.github.com
Maintainer Communityhttps://maintainers.github.com
Acceleratorhttps://github.com/open-source/accelerator
GitHub Starshttps://stars.github.com
Archive Programhttps://archiveprogram.github.com
Topicshttps://github.com/topics
Trendinghttps://github.com/trending
Collectionshttps://github.com/collections
Enterprise platformAI-powered developer platformhttps://github.com/enterprise
GitHub Advanced SecurityEnterprise-grade security featureshttps://github.com/security/advanced-security
Copilot for BusinessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Pricinghttps://github.com/pricing
Search syntax tipshttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
documentationhttps://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2F2454
Sign up https://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=modelcontextprotocol%2Fpython-sdk
Reloadhttps://github.com/modelcontextprotocol/python-sdk/issues/2454
Reloadhttps://github.com/modelcontextprotocol/python-sdk/issues/2454
Reloadhttps://github.com/modelcontextprotocol/python-sdk/issues/2454
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/issues/2454
modelcontextprotocol https://github.com/modelcontextprotocol
python-sdkhttps://github.com/modelcontextprotocol/python-sdk
Notifications https://github.com/login?return_to=%2Fmodelcontextprotocol%2Fpython-sdk
Fork 3.7k https://github.com/login?return_to=%2Fmodelcontextprotocol%2Fpython-sdk
Star 23.6k https://github.com/login?return_to=%2Fmodelcontextprotocol%2Fpython-sdk
Code https://github.com/modelcontextprotocol/python-sdk
Issues 259 https://github.com/modelcontextprotocol/python-sdk/issues
Pull requests 306 https://github.com/modelcontextprotocol/python-sdk/pulls
Actions https://github.com/modelcontextprotocol/python-sdk/actions
Projects https://github.com/modelcontextprotocol/python-sdk/projects
Models https://github.com/modelcontextprotocol/python-sdk/models
Security and quality 6 https://github.com/modelcontextprotocol/python-sdk/security
Insights https://github.com/modelcontextprotocol/python-sdk/pulse
Code https://github.com/modelcontextprotocol/python-sdk
Issues https://github.com/modelcontextprotocol/python-sdk/issues
Pull requests https://github.com/modelcontextprotocol/python-sdk/pulls
Actions https://github.com/modelcontextprotocol/python-sdk/actions
Projects https://github.com/modelcontextprotocol/python-sdk/projects
Models https://github.com/modelcontextprotocol/python-sdk/models
Security and quality https://github.com/modelcontextprotocol/python-sdk/security
Insights https://github.com/modelcontextprotocol/python-sdk/pulse
#2907https://github.com/modelcontextprotocol/python-sdk/pull/2907
#2456https://github.com/modelcontextprotocol/python-sdk/pull/2456
stdio_client crashes on malformed UTF-8 from child stdout instead of surfacing parse errorhttps://github.com/modelcontextprotocol/python-sdk/issues/2454#top
#2907https://github.com/modelcontextprotocol/python-sdk/pull/2907
#2456https://github.com/modelcontextprotocol/python-sdk/pull/2456
P2Moderate issues affecting some users, edge cases, potentially valuable featurehttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22P2%22
bugSomething isn't workinghttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22bug%22
fix proposedBot has a verified fix diff in the commenthttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22fix%20proposed%22
ready for workEnough information for someone to start working onhttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22ready%20for%20work%22
https://github.com/shaun0927
shaun0927https://github.com/shaun0927
on Apr 16, 2026https://github.com/modelcontextprotocol/python-sdk/issues/2454#issue-4276797834
#2302https://github.com/modelcontextprotocol/python-sdk/pull/2302
#2302https://github.com/modelcontextprotocol/python-sdk/pull/2302
P2Moderate issues affecting some users, edge cases, potentially valuable featurehttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22P2%22
bugSomething isn't workinghttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22bug%22
fix proposedBot has a verified fix diff in the commenthttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22fix%20proposed%22
ready for workEnough information for someone to start working onhttps://github.com/modelcontextprotocol/python-sdk/issues?q=state%3Aopen%20label%3A%22ready%20for%20work%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.