René's URL Explorer Experiment


Title: feat: add idle timeout for StreamableHTTP sessions by felixweinberger · Pull Request #1994 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: feat: add idle timeout for StreamableHTTP sessions by felixweinberger · Pull Request #1994 · modelcontextprotocol/python-sdk

X Title: feat: add idle timeout for StreamableHTTP sessions by felixweinberger · Pull Request #1994 · modelcontextprotocol/python-sdk

Description: Summary Adds a session_idle_timeout parameter to StreamableHTTPSessionManager that enables automatic cleanup of idle sessions, fixing the memory leak described in #1283. Motivation and Context Sessions created via StreamableHTTPSessionManager persist indefinitely in _server_instances even after clients disconnect without sending DELETE. Over time this leaks memory. This was reported in #1283 and originally addressed in #1159 by @hopeful0 — this PR reworks that approach. Key design decisions: Uses a CancelScope with a deadline inside each session's run_server task. When the deadline passes, app.run() is cancelled and the session cleans up. No background tasks needed — each session manages its own lifecycle. Incoming requests push the deadline forward, so active sessions are never terminated. terminate() on the transport is now idempotent (early return if already terminated). Default is None (no timeout, fully backwards compatible). Docstring recommends 1800s (30 min) for most deployments. How Has This Been Tested? Tests added to tests/server/test_streamable_http_manager.py: idle session reaping (deterministic, no sleeps), terminate idempotency, and parameterized input validation. All existing tests pass unchanged. Breaking Changes None. session_idle_timeout defaults to None (no timeout). 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 Based on the approach from PR #1159 by @hopeful0, reworked to use cancel scope deadlines instead of transport-level timeout logic. Closes #1283

Open Graph Description: Summary Adds a session_idle_timeout parameter to StreamableHTTPSessionManager that enables automatic cleanup of idle sessions, fixing the memory leak described in #1283. Motivation and Context Sess...

X Description: Summary Adds a session_idle_timeout parameter to StreamableHTTPSessionManager that enables automatic cleanup of idle sessions, fixing the memory leak described in #1283. Motivation and Context Sess...

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

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:260a993d-317c-0aaf-c366-2a36f9b81db0
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idC984:2C32F8:17D5CF:1EC4B3:6A5BE9EE
html-safe-nonce62d0f847e80d65da274507d79c9a4b610cebda087d67e3c880ea8814733b460e
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDOTg0OjJDMzJGODoxN0Q1Q0Y6MUVDNEIzOjZBNUJFOUVFIiwidmlzaXRvcl9pZCI6IjMyNjY4MjA0MjEzOTY5ODIyNTQiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac93f316f7e738b16cb8d72cff522a92bbd66e9d38db1f80efb9f5f3aa275ab2bf
hovercard-subject-tagpull_request:3246851507
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/1994/files
twitter:imagehttps://avatars.githubusercontent.com/u/3823880?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/3823880?s=400&v=4
og:image:altSummary Adds a session_idle_timeout parameter to StreamableHTTPSessionManager that enables automatic cleanup of idle sessions, fixing the memory leak described in #1283. Motivation and Context Sess...
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/1994/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F1994%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%2F1994%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/1994/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1994/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
felixweinbergerhttps://github.com/felixweinberger
v1.xhttps://github.com/modelcontextprotocol/python-sdk/tree/v1.x
fweinberger/idle-timeout-terminationhttps://github.com/modelcontextprotocol/python-sdk/tree/fweinberger/idle-timeout-termination
Conversation 24 https://github.com/modelcontextprotocol/python-sdk/pull/1994
Commits 5 https://github.com/modelcontextprotocol/python-sdk/pull/1994/commits
Checks 19 https://github.com/modelcontextprotocol/python-sdk/pull/1994/checks
Files changed 4 https://github.com/modelcontextprotocol/python-sdk/pull/1994/files
feat: add idle timeout for StreamableHTTP sessions https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#top
Show all changes 5 commits https://github.com/modelcontextprotocol/python-sdk/pull/1994/files
2c87708 feat: add idle timeout for StreamableHTTP sessions felixweinberger Feb 9, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/1994/commits/2c87708cfd3129b341d7c43cb5a2c83c4982515b
7345bd7 Clean up idle timeout implementation felixweinberger Feb 9, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/1994/commits/7345bd7161bf9176952a43b7ef6aa69dd03ec4f1
2c9e60c Remove _effective_idle_timeout, use session_idle_timeout directly felixweinberger Feb 9, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/1994/commits/2c9e60cc9a2105bf8198337c23e1f52a1ca50a5f
d5686df Address review feedback: docstring formatting, test reorganization felixweinberger Feb 16, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/1994/commits/d5686df2b42df4faea1a2a31e80575667c9fba3c
4191aa6 Address latest review feedback felixweinberger Feb 16, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/1994/commits/4191aa65db3b5df2bce22509cd0e51da42b5972f
Clear filters https://github.com/modelcontextprotocol/python-sdk/pull/1994/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files
CLAUDE.md https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-6ebdb617a8104a7756d0cf36578ab01103dc9f07e4dc6feb751296b9c402faf7
streamable_http.py https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-0119e4c1bbf2fde7ba89b9c9f5bc472ccc2332f84e96e47cf9e45cebef801da3
streamable_http_manager.py https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-1071ee05567116cb77322c376307b9071c6212871068ccf41911fc337ed473af
test_streamable_http_manager.py https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-ee0bac8ccf39135f1347002539cc4af38ee7e89b85595884e94fb4ab304a111d
CLAUDE.mdhttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-6ebdb617a8104a7756d0cf36578ab01103dc9f07e4dc6feb751296b9c402faf7
View file https://github.com/modelcontextprotocol/python-sdk/blob/4191aa65db3b5df2bce22509cd0e51da42b5972f/CLAUDE.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/1994/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-6ebdb617a8104a7756d0cf36578ab01103dc9f07e4dc6feb751296b9c402faf7
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-6ebdb617a8104a7756d0cf36578ab01103dc9f07e4dc6feb751296b9c402faf7
src/mcp/server/streamable_http.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-0119e4c1bbf2fde7ba89b9c9f5bc472ccc2332f84e96e47cf9e45cebef801da3
View file https://github.com/modelcontextprotocol/python-sdk/blob/4191aa65db3b5df2bce22509cd0e51da42b5972f/src/mcp/server/streamable_http.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/1994/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-0119e4c1bbf2fde7ba89b9c9f5bc472ccc2332f84e96e47cf9e45cebef801da3
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-0119e4c1bbf2fde7ba89b9c9f5bc472ccc2332f84e96e47cf9e45cebef801da3
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-0119e4c1bbf2fde7ba89b9c9f5bc472ccc2332f84e96e47cf9e45cebef801da3
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-0119e4c1bbf2fde7ba89b9c9f5bc472ccc2332f84e96e47cf9e45cebef801da3
src/mcp/server/streamable_http_manager.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-1071ee05567116cb77322c376307b9071c6212871068ccf41911fc337ed473af
View file https://github.com/modelcontextprotocol/python-sdk/blob/4191aa65db3b5df2bce22509cd0e51da42b5972f/src/mcp/server/streamable_http_manager.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/1994/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-1071ee05567116cb77322c376307b9071c6212871068ccf41911fc337ed473af
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-1071ee05567116cb77322c376307b9071c6212871068ccf41911fc337ed473af
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-1071ee05567116cb77322c376307b9071c6212871068ccf41911fc337ed473af
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-1071ee05567116cb77322c376307b9071c6212871068ccf41911fc337ed473af
Kludexhttps://github.com/Kludex
Feb 16, 2026https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#r2812333149
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files
felixweinbergerhttps://github.com/felixweinberger
Feb 16, 2026https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#r2812946697
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-1071ee05567116cb77322c376307b9071c6212871068ccf41911fc337ed473af
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-1071ee05567116cb77322c376307b9071c6212871068ccf41911fc337ed473af
tests/server/test_streamable_http_manager.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-ee0bac8ccf39135f1347002539cc4af38ee7e89b85595884e94fb4ab304a111d
View file https://github.com/modelcontextprotocol/python-sdk/blob/4191aa65db3b5df2bce22509cd0e51da42b5972f/tests/server/test_streamable_http_manager.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/1994/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#diff-ee0bac8ccf39135f1347002539cc4af38ee7e89b85595884e94fb4ab304a111d
felixweinbergerhttps://github.com/felixweinberger
Feb 16, 2026https://github.com/modelcontextprotocol/python-sdk/pull/1994/files#r2813085845
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/1994/files
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.