René's URL Explorer Experiment


Title: Fix issue #428: ClientSession.initialize gets stuck if the MCP server process exits by AshwanthramKL · Pull Request #434 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: Fix issue #428: ClientSession.initialize gets stuck if the MCP server process exits by AshwanthramKL · Pull Request #434 · modelcontextprotocol/python-sdk

X Title: Fix issue #428: ClientSession.initialize gets stuck if the MCP server process exits by AshwanthramKL · Pull Request #434 · modelcontextprotocol/python-sdk

Description: This PR fixes an issue where ClientSession.initialize gets stuck indefinitely if the MCP server process exits unexpectedly. Motivation and Context When using stdio_client to connect to an MCP server, if the server process exits unexpectedly (e.g., due to missing API keys or configuration), the client hangs indefinitely without raising an appropriate exception. This makes for a poor developer experience and can be frustrating to debug. How Has This Been Tested? Added a test case that verifies the fix works correctly by creating a server that exits during initialization and checking that the appropriate exception is raised. The test ensures that the client properly detects when the server process exits and raises a ProcessTerminatedEarlyError instead of hanging indefinitely. Breaking Changes None. This change only improves error handling and doesn't modify any existing APIs. Types of changes Bug fix (non-breaking change which fixes an issue) New feature (non-breaking change which adds functionality) Breaking change (fix or feature that would cause existing functionality to change) Documentation update Checklist I have read the MCP Documentation My code follows the repository's style guidelines New and existing tests pass locally I have added appropriate error handling I have added or updated documentation as needed Additional context The solution adds a process monitoring task that detects when the server process exits unexpectedly and raises a ProcessTerminatedEarlyError with a descriptive message. It also ensures proper cleanup of resources to prevent leaks. Specifically: Added a ProcessTerminatedEarlyError exception class Added a process monitoring task that detects when the process exits unexpectedly Properly closed all streams to prevent resource leaks Added error handling for the case where the process has already exited Made sure we don't raise an error when we explicitly terminate the process Fixes #428

Open Graph Description: This PR fixes an issue where ClientSession.initialize gets stuck indefinitely if the MCP server process exits unexpectedly. Motivation and Context When using stdio_client to connect to an MCP serv...

X Description: This PR fixes an issue where ClientSession.initialize gets stuck indefinitely if the MCP server process exits unexpectedly. Motivation and Context When using stdio_client to connect to an MCP serv...

Opengraph URL: https://github.com/modelcontextprotocol/python-sdk/pull/434

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:99c92927-0ed2-d46d-23e7-cc3469f9f3d8
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idA488:1C9D94:C62B95:100F3B4:6A5C20E2
html-safe-noncec0f56944096f95485774a445c753ddfec7cdd84a3e972da81fc9a699aed0dde2
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBNDg4OjFDOUQ5NDpDNjJCOTU6MTAwRjNCNDo2QTVDMjBFMiIsInZpc2l0b3JfaWQiOiI1NTc3NjE2OTQ1MjQyMTg1OTU0IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac2bf0dd2cb1ff162880c02dcbced478ef358b60d0dd6368036637fd41bedde266
hovercard-subject-tagpull_request:2441027061
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/modelcontextprotocol/python-sdk/pull/434/files
twitter:imagehttps://avatars.githubusercontent.com/u/71945723?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/71945723?s=400&v=4
og:image:altThis PR fixes an issue where ClientSession.initialize gets stuck indefinitely if the MCP server process exits unexpectedly. Motivation and Context When using stdio_client to connect to an MCP serv...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None5290d7e14309ad1e76106a9c4237bd1041517e83ea182c8ab756752cb0c6940b
turbo-cache-controlno-preview
diff-viewunified
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 full-width
disable-turbotrue
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/pull/434/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F434%2Ffiles
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%2Fpull%2F434%2Ffiles
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%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=modelcontextprotocol%2Fpython-sdk
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/434/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/434/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/434/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/434/files
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.7k 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 307 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
Sign up for GitHub https://github.com/signup?return_to=%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2Fnew%2Fchoose
AshwanthramKLhttps://github.com/AshwanthramKL
modelcontextprotocol:mainhttps://github.com/modelcontextprotocol/python-sdk/tree/main
AshwanthramKL:fix/428-stdio-client-hanghttps://github.com/AshwanthramKL/python-sdk/tree/fix/428-stdio-client-hang
Conversation 2 https://github.com/modelcontextprotocol/python-sdk/pull/434
Commits 1 https://github.com/modelcontextprotocol/python-sdk/pull/434/commits
Checks 0 https://github.com/modelcontextprotocol/python-sdk/pull/434/checks
Files changed https://github.com/modelcontextprotocol/python-sdk/pull/434/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/434/files
Fix issue #428: ClientSession.initialize gets stuck if the MCP server process exits https://github.com/modelcontextprotocol/python-sdk/pull/434/files#top
Show all changes 1 commit https://github.com/modelcontextprotocol/python-sdk/pull/434/files
728ec85 Fix issue #428: ClientSession.initialize gets stuck if the MCP server… AshwanthramKL Apr 5, 2025 https://github.com/modelcontextprotocol/python-sdk/pull/434/commits/728ec85bb60f8ff195b3f8fa2700de2ddacb511c
Clear filters https://github.com/modelcontextprotocol/python-sdk/pull/434/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/434/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/434/files
__init__.py https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-208c9cff9cd42bad47f1042db6861d931673ca78db6de12bd4d8f65885f8f126
__init__.py https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-2d78210c1f729556ae6d443eb0e255394d786171d32842ff2f8dea90d096da39
test_stdio.py https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-49f66b09e4d89b29b440c955c429fe948dbcc3bbb08fffb504cf40be24382352
src/mcp/__init__.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-208c9cff9cd42bad47f1042db6861d931673ca78db6de12bd4d8f65885f8f126
View file https://github.com/AshwanthramKL/python-sdk/blob/728ec85bb60f8ff195b3f8fa2700de2ddacb511c/src/mcp/__init__.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/434/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-208c9cff9cd42bad47f1042db6861d931673ca78db6de12bd4d8f65885f8f126
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-208c9cff9cd42bad47f1042db6861d931673ca78db6de12bd4d8f65885f8f126
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-208c9cff9cd42bad47f1042db6861d931673ca78db6de12bd4d8f65885f8f126
src/mcp/client/stdio/__init__.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-2d78210c1f729556ae6d443eb0e255394d786171d32842ff2f8dea90d096da39
View file https://github.com/AshwanthramKL/python-sdk/blob/728ec85bb60f8ff195b3f8fa2700de2ddacb511c/src/mcp/client/stdio/__init__.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/434/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-2d78210c1f729556ae6d443eb0e255394d786171d32842ff2f8dea90d096da39
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-2d78210c1f729556ae6d443eb0e255394d786171d32842ff2f8dea90d096da39
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-2d78210c1f729556ae6d443eb0e255394d786171d32842ff2f8dea90d096da39
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-2d78210c1f729556ae6d443eb0e255394d786171d32842ff2f8dea90d096da39
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-2d78210c1f729556ae6d443eb0e255394d786171d32842ff2f8dea90d096da39
tests/client/test_stdio.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-49f66b09e4d89b29b440c955c429fe948dbcc3bbb08fffb504cf40be24382352
View file https://github.com/AshwanthramKL/python-sdk/blob/728ec85bb60f8ff195b3f8fa2700de2ddacb511c/tests/client/test_stdio.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/434/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-49f66b09e4d89b29b440c955c429fe948dbcc3bbb08fffb504cf40be24382352
https://github.com/modelcontextprotocol/python-sdk/pull/434/files#diff-49f66b09e4d89b29b440c955c429fe948dbcc3bbb08fffb504cf40be24382352
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.