René's URL Explorer Experiment


Title: Update the v2 status banner and pin spawned environments to the running SDK version by maxisbey · Pull Request #2834 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: Update the v2 status banner and pin spawned environments to the running SDK version by maxisbey · Pull Request #2834 · modelcontextprotocol/python-sdk

X Title: Update the v2 status banner and pin spawned environments to the running SDK version by maxisbey · Pull Request #2834 · modelcontextprotocol/python-sdk

Description: Two pre-alpha-release fixes in one PR, per maintainer discussion. Motivation and Context README banner: the front-page README.md still described v2 as "pre-alpha, in development". With 2.0.0a1 about to be published, it now states the alpha status, how to install it, the beta/stable target dates, the <2 upper-bound ask for dependent packages, and v1.x's maintenance-mode status. README.md is deliberately frozen on main (it documents v1), so the freeze CI check now honors an override-readme-freeze label for intentional updates like this one; accidental edits stay blocked. CLI version pinning: mcp dev and mcp install build commands of the form uv run --with mcp ... / uv run --with mcp[cli] .... In a fresh environment an unpinned mcp requirement resolves to the latest stable release - never a pre-release - so a user who installed mcp[cli]==2.0.0a1 and ran mcp dev server.py (outside a uv project) or mcp install got a child environment with v1 in it, and their v2 server failed with ModuleNotFoundError. The mcp install case is the worst variant: the broken command is persisted into Claude Desktop's config. Both sites now pin the requirement to the running SDK version (mcp[cli]==). Source builds carry dev/local version segments that are not on PyPI, so they fall back to the unpinned form. How Has This Been Tested? Reproduced the failure first: uv run --with mcp python -c "from mcp.server.mcpserver import MCPServer" resolves mcp 1.27.2 and fails the import. New tests for the requirement helper cover all three version shapes (release -> pinned, .dev -> unpinned, +local -> unpinned), and the command-construction tests now mock the SDK version so they are deterministic across environments (the repo venv runs a dev build; CI may produce a different version). tests/cli/ passes (26 tests), 100% branch coverage on src/mcp/cli/*, strict-no-cover clean, pyright and ruff clean. Breaking Changes None. Claude Desktop configs written by older versions keep their unpinned form until mcp install is re-run. 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 A companion PR updates the v1.x branch's README with the same v2 status information, since that branch's README is what PyPI renders for the stable line. AI Disclaimer

Open Graph Description: Two pre-alpha-release fixes in one PR, per maintainer discussion. Motivation and Context README banner: the front-page README.md still described v2 as "pre-alpha, in development". With 2....

X Description: Two pre-alpha-release fixes in one PR, per maintainer discussion. Motivation and Context README banner: the front-page README.md still described v2 as &quot;pre-alpha, in development&quot;....

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

X: @github

direct link

Domain: github.com

route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:4204cbb7-d6ec-f7ad-385a-3c5276b61358
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idA02C:29BE21:505A3E:6DD1EF:6A61AD05
html-safe-nonce296e86ca9aa953df90faba0a32ec08f94b4d7eaea5d4fae97fd0027d49562b86
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBMDJDOjI5QkUyMTo1MDVBM0U6NkREMUVGOjZBNjFBRDA1IiwidmlzaXRvcl9pZCI6IjcwMDc0MTM1NTUyNDA3NDIxNDkiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmac163b1f10253014d467c27ff4a0c72f0d51169745a7d7f95f4b7549e03da0c313
hovercard-subject-tagpull_request:3845644577
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/2834/files
twitter:imagehttps://avatars.githubusercontent.com/u/224885523?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/224885523?s=400&v=4
og:image:altTwo pre-alpha-release fixes in one PR, per maintainer discussion. Motivation and Context README banner: the front-page README.md still described v2 as "pre-alpha, in development". With 2....
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None6f4633bcf01c1ad14b73fd07dd39ac31d61f3d3c2578ee08ec1792b7b351eeb9
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
releaseac296ae7f21856f1f92adbad22f870b6fbb4b907
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files#start-of-content
https://github.com/
Sign in https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F2834%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
Code QualityEnforce quality at mergehttps://github.com/features/code-quality
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%2F2834%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/2834/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2834/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 268 https://github.com/modelcontextprotocol/python-sdk/issues
Pull requests 313 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
maxisbeyhttps://github.com/maxisbey
mainhttps://github.com/modelcontextprotocol/python-sdk/tree/main
v2-readme-and-cli-pinhttps://github.com/modelcontextprotocol/python-sdk/tree/v2-readme-and-cli-pin
Conversation 2 https://github.com/modelcontextprotocol/python-sdk/pull/2834
Commits 2 https://github.com/modelcontextprotocol/python-sdk/pull/2834/commits
Checks 32 https://github.com/modelcontextprotocol/python-sdk/pull/2834/checks
Files changed https://github.com/modelcontextprotocol/python-sdk/pull/2834/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files
Update the v2 status banner and pin spawned environments to the running SDK version https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#top
Show all changes 2 commits https://github.com/modelcontextprotocol/python-sdk/pull/2834/files
ae217fd Update the v2 status banner and pin spawned environments to the runni… maxisbey Jun 11, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/2834/commits/ae217fd0c0c76e846210745251267dd500d34706
0322681 Fall back to unpinned mcp when distribution metadata is missing maxisbey Jun 11, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/2834/commits/0322681189475bde817d51b0a6161fe6ee548204
Clear filters https://github.com/modelcontextprotocol/python-sdk/pull/2834/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files
shared.yml https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-9852c0f7d79fa9d5200f11511ffdbadc321f7115fe1c5e8d2f2e63863d2441ee
README.md https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5
claude.py https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b9cc4f521f80017ffb9a4cbc1a52da9c9cba4fd372598f4575a4336e2b9a3cf4
cli.py https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-ed6a22760239e76508d462209c10b7f07612896965b7808478261a9c529b796e
test_claude.py https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-2dc8d306767125c166e3ce489818c798b31119e33b340b32c21fca77d5a02c3b
test_utils.py https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-d73e532773442934c4c4fb02a30c0642187173a01243a2d646f5cda99b09f65d
.github/workflows/shared.ymlhttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-9852c0f7d79fa9d5200f11511ffdbadc321f7115fe1c5e8d2f2e63863d2441ee
View file https://github.com/modelcontextprotocol/python-sdk/blob/0322681189475bde817d51b0a6161fe6ee548204/.github/workflows/shared.yml
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2834/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-9852c0f7d79fa9d5200f11511ffdbadc321f7115fe1c5e8d2f2e63863d2441ee
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-9852c0f7d79fa9d5200f11511ffdbadc321f7115fe1c5e8d2f2e63863d2441ee
README.mdhttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5
View file https://github.com/modelcontextprotocol/python-sdk/blob/0322681189475bde817d51b0a6161fe6ee548204/README.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2834/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5
src/mcp/cli/claude.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b9cc4f521f80017ffb9a4cbc1a52da9c9cba4fd372598f4575a4336e2b9a3cf4
View file https://github.com/modelcontextprotocol/python-sdk/blob/0322681189475bde817d51b0a6161fe6ee548204/src/mcp/cli/claude.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2834/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b9cc4f521f80017ffb9a4cbc1a52da9c9cba4fd372598f4575a4336e2b9a3cf4
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b9cc4f521f80017ffb9a4cbc1a52da9c9cba4fd372598f4575a4336e2b9a3cf4
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b9cc4f521f80017ffb9a4cbc1a52da9c9cba4fd372598f4575a4336e2b9a3cf4
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-b9cc4f521f80017ffb9a4cbc1a52da9c9cba4fd372598f4575a4336e2b9a3cf4
src/mcp/cli/cli.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-ed6a22760239e76508d462209c10b7f07612896965b7808478261a9c529b796e
View file https://github.com/modelcontextprotocol/python-sdk/blob/0322681189475bde817d51b0a6161fe6ee548204/src/mcp/cli/cli.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2834/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-ed6a22760239e76508d462209c10b7f07612896965b7808478261a9c529b796e
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-ed6a22760239e76508d462209c10b7f07612896965b7808478261a9c529b796e
tests/cli/test_claude.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-2dc8d306767125c166e3ce489818c798b31119e33b340b32c21fca77d5a02c3b
View file https://github.com/modelcontextprotocol/python-sdk/blob/0322681189475bde817d51b0a6161fe6ee548204/tests/cli/test_claude.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2834/{{ revealButtonHref }}
felixweinbergerhttps://github.com/felixweinberger
Jun 11, 2026https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#r3394478314
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files
maxisbeyhttps://github.com/maxisbey
Jun 11, 2026https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#r3394482396
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-2dc8d306767125c166e3ce489818c798b31119e33b340b32c21fca77d5a02c3b
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-2dc8d306767125c166e3ce489818c798b31119e33b340b32c21fca77d5a02c3b
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-2dc8d306767125c166e3ce489818c798b31119e33b340b32c21fca77d5a02c3b
tests/cli/test_utils.pyhttps://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-d73e532773442934c4c4fb02a30c0642187173a01243a2d646f5cda99b09f65d
View file https://github.com/modelcontextprotocol/python-sdk/blob/0322681189475bde817d51b0a6161fe6ee548204/tests/cli/test_utils.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/2834/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-d73e532773442934c4c4fb02a30c0642187173a01243a2d646f5cda99b09f65d
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-d73e532773442934c4c4fb02a30c0642187173a01243a2d646f5cda99b09f65d
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-d73e532773442934c4c4fb02a30c0642187173a01243a2d646f5cda99b09f65d
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-d73e532773442934c4c4fb02a30c0642187173a01243a2d646f5cda99b09f65d
https://github.com/modelcontextprotocol/python-sdk/pull/2834/files#diff-d73e532773442934c4c4fb02a30c0642187173a01243a2d646f5cda99b09f65d
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/2834/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.