René's URL Explorer Experiment


Title: Add story-style examples suite (27 stories + harness + CI) by maxisbey · Pull Request #2957 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: Add story-style examples suite (27 stories + harness + CI) by maxisbey · Pull Request #2957 · modelcontextprotocol/python-sdk

X Title: Add story-style examples suite (27 stories + harness + CI) by maxisbey · Pull Request #2957 · modelcontextprotocol/python-sdk

Description: The official Python SDK for Model Context Protocol servers and clients - Add story-style examples suite (27 stories + harness + CI) by maxisbey · Pull Request #2957 · modelcontextprotocol/python-sdk

Open Graph Description: Adds a story-style examples suite: one self-contained folder per protocol feature, each with server.py (MCPServer), server_lowlevel.py (lowlevel Server), client.py, and README.md. Mirrors the types...

X Description: Adds a story-style examples suite: one self-contained folder per protocol feature, each with server.py (MCPServer), server_lowlevel.py (lowlevel Server), client.py, and README.md. Mirrors the types...

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

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/commits(.:format)
route-controllerpull_requests
route-actioncommits
fetch-noncev2:b67b9ce2-1393-3124-4abf-34f1790cc1f6
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idB404:2975D6:422FBD:5899EB:6A5B2926
html-safe-nonce1d3874028ecdf3845c89fcd2687d027424e15d847224bcb124288b873acc015e
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCNDA0OjI5NzVENjo0MjJGQkQ6NTg5OUVCOjZBNUIyOTI2IiwidmlzaXRvcl9pZCI6IjU1MTk4MDAzODQ3MjA5MzkzMDMiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmacfdcdd8868d3972035669ee514cdac1ea8e9161a53c20207f45df9f49e73685c6
hovercard-subject-tagpull_request:3923154184
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/commits
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits
twitter:imagehttps://opengraph.githubassets.com/baee3d375504d7733256f8fce83919d7e747b91e2a88d17b77faf025f6eab168/modelcontextprotocol/python-sdk/pull/2957
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/baee3d375504d7733256f8fce83919d7e747b91e2a88d17b77faf025f6eab168/modelcontextprotocol/python-sdk/pull/2957
og:image:altAdds a story-style examples suite: one self-contained folder per protocol feature, each with server.py (MCPServer), server_lowlevel.py (lowlevel Server), client.py, and README.md. Mirrors the types...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamemaxisbey
hostnamegithub.com
expected-hostnamegithub.com
None5290d7e14309ad1e76106a9c4237bd1041517e83ea182c8ab756752cb0c6940b
turbo-cache-controlno-cache
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/pull/2957/commits#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F2957%2Fcommits
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%2F2957%2Fcommits
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%2Fcommits&source=header-repo&source_repo=modelcontextprotocol%2Fpython-sdk
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits
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 258 https://github.com/modelcontextprotocol/python-sdk/issues
Pull requests 301 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
maxisbeyhttps://github.com/maxisbey
mainhttps://github.com/modelcontextprotocol/python-sdk/tree/main
examples-story-suitehttps://github.com/modelcontextprotocol/python-sdk/tree/examples-story-suite
Conversationhttps://github.com/modelcontextprotocol/python-sdk/pull/2957
Commits17 (17)https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits
Checkshttps://github.com/modelcontextprotocol/python-sdk/pull/2957/checks
Files changedhttps://github.com/modelcontextprotocol/python-sdk/pull/2957/files
Add story-style examples suite (27 stories + harness + CI)https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits#top
maxisbeyhttps://github.com/maxisbey
mainhttps://github.com/modelcontextprotocol/python-sdk/tree/main
examples-story-suitehttps://github.com/modelcontextprotocol/python-sdk/tree/examples-story-suite
Add story-style examples suite (29 stories + harness + CI)https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/b7cb400f4b417fffcba6c25fff37ed6b035d8eb9
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
b7cb400https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/b7cb400f4b417fffcba6c25fff37ed6b035d8eb9
https://github.com/modelcontextprotocol/python-sdk/tree/b7cb400f4b417fffcba6c25fff37ed6b035d8eb9
Remove examples superseded by stories/; update dangling referenceshttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/488e343c2560866a009fff114b7a92b4fefaa905
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
488e343https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/488e343c2560866a009fff114b7a92b4fefaa905
https://github.com/modelcontextprotocol/python-sdk/tree/488e343c2560866a009fff114b7a92b4fefaa905
Remove no-cover pragmas for paths now exercised by story exampleshttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/70c9233e4ab80c4be33fc3ef14691547552b4859
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
70c9233https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/70c9233e4ab80c4be33fc3ef14691547552b4859
https://github.com/modelcontextprotocol/python-sdk/tree/70c9233e4ab80c4be33fc3ef14691547552b4859
Drop internal tracking codes from conftest docstringshttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/1a839277ecad5e45174e02ca176393d42cc64fe3
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
1a83927https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/1a839277ecad5e45174e02ca176393d42cc64fe3
https://github.com/modelcontextprotocol/python-sdk/tree/1a839277ecad5e45174e02ca176393d42cc64fe3
Restore old example directories; fix typing.TypedDict on Python < 3.12https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/bf8a62bee5c77ee0dd3ef9bb9bb9dc34b1d12edf
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
bf8a62bhttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/bf8a62bee5c77ee0dd3ef9bb9bb9dc34b1d12edf
https://github.com/modelcontextprotocol/python-sdk/tree/bf8a62bee5c77ee0dd3ef9bb9bb9dc34b1d12edf
Restore original references to old example dirs (revert remainder)https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/123b265506826f4a8d52bc1ca4054ae3c58d1dfb
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
123b265https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/123b265506826f4a8d52bc1ca4054ae3c58d1dfb
https://github.com/modelcontextprotocol/python-sdk/tree/123b265506826f4a8d52bc1ca4054ae3c58d1dfb
Add lax no cover to both arms of tomllib version-gatehttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/4ef42e989c1a80f8da1d10a66e7d423a55c03023
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
4ef42e9https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/4ef42e989c1a80f8da1d10a66e7d423a55c03023
https://github.com/modelcontextprotocol/python-sdk/tree/4ef42e989c1a80f8da1d10a66e7d423a55c03023
Show Client construction in every story; cut/rename stories per reviewhttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/2c85d921cc8409ee7df25550efb953cf3e5becb0
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
2c85d92https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/2c85d921cc8409ee7df25550efb953cf3e5becb0
https://github.com/modelcontextprotocol/python-sdk/tree/2c85d921cc8409ee7df25550efb953cf3e5becb0
Add a story shape-check; document the canonical example shapehttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/8abdafc596def072d15bc6d7f4502d81868a3513
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
8abdafchttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/8abdafc596def072d15bc6d7f4502d81868a3513
https://github.com/modelcontextprotocol/python-sdk/tree/8abdafc596def072d15bc6d7f4502d81868a3513
Adapt the story suite to the merged 2026 client surfacehttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/dd28eb4f9aeae69b4317adcf66d988cafed1cfe8
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
dd28eb4https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/dd28eb4f9aeae69b4317adcf66d988cafed1cfe8
https://github.com/modelcontextprotocol/python-sdk/tree/dd28eb4f9aeae69b4317adcf66d988cafed1cfe8
Address example-suite review findingshttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/c6d7bb61af5815ad0784d3151e459b6b8c989e8b
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
c6d7bb6https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/c6d7bb61af5815ad0784d3151e459b6b8c989e8b
https://github.com/modelcontextprotocol/python-sdk/tree/c6d7bb61af5815ad0784d3151e459b6b8c989e8b
READMEs: capture the server PID instead of relying on job controlhttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/842d61910b524c50fbdae45fbe28d787cf3a2b38
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
842d619https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/842d61910b524c50fbdae45fbe28d787cf3a2b38
https://github.com/modelcontextprotocol/python-sdk/tree/842d61910b524c50fbdae45fbe28d787cf3a2b38
Let client.py self-host its server for HTTP runshttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/c223fecda0a7f1b6c68daa3810c67fb1f1da849b
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
c223fechttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/c223fecda0a7f1b6c68daa3810c67fb1f1da849b
https://github.com/modelcontextprotocol/python-sdk/tree/c223fecda0a7f1b6c68daa3810c67fb1f1da849b
Adapt story suite to the mcp-types package split after rebasehttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/27438a5502d95fe79cd55760fc38a7271ed0946f
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
27438a5https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/27438a5502d95fe79cd55760fc38a7271ed0946f
https://github.com/modelcontextprotocol/python-sdk/tree/27438a5502d95fe79cd55760fc38a7271ed0946f
Address story-suite review findingshttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/b7081bf5f037d4f8b2e31ed2c7d20f401ccbd51b
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
b7081bfhttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/b7081bf5f037d4f8b2e31ed2c7d20f401ccbd51b
https://github.com/modelcontextprotocol/python-sdk/tree/b7081bf5f037d4f8b2e31ed2c7d20f401ccbd51b
Adapt the legacy_routing story to the Mcp-Method header rung in classify_inbound_requesthttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/fa9c543b6655d2be1b634000aedb80584b077f7f
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
fa9c543https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/fa9c543b6655d2be1b634000aedb80584b077f7f
https://github.com/modelcontextprotocol/python-sdk/tree/fa9c543b6655d2be1b634000aedb80584b077f7f
legacy_routing README: name the Mcp-Method header runghttps://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/23b42a39352b5f2563efde331bb77b2f9b4364b3
https://github.com/maxisbey
maxisbeyhttps://github.com/modelcontextprotocol/python-sdk/commits?author=maxisbey
23b42a3https://github.com/modelcontextprotocol/python-sdk/pull/2957/commits/23b42a39352b5f2563efde331bb77b2f9b4364b3
https://github.com/modelcontextprotocol/python-sdk/tree/23b42a39352b5f2563efde331bb77b2f9b4364b3
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.