modelcontextprotocol/python-sdk
Watch
1
0
Fork
You've already forked python-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Point pre-release install pins at 2.0.0b1 (#3039)
Some checks failed
CI / checks (push) Has been cancelled
Details
CI / all-green (push) Has been cancelled
Details

Browse source
This commit is contained in:
Max 2026-07-01 00:14:52 +01:00 • committed by GitHub
commit 0da9092037
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 11 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

4
README.md
View file

@ -41,10 +41,10 @@ Python 3.10+.
## Installation ## Installation
```bash ```bash
uv add "mcp[cli]==2.0.0a3" # or: pip install "mcp[cli]==2.0.0a3" uv add "mcp[cli]==2.0.0b1" # or: pip install "mcp[cli]==2.0.0b1"
``` ```
The pin matters while v2 is in pre-release: an unpinned install resolves to the latest stable v1.x, which this README does not describe. Check [PyPI](https://pypi.org/project/mcp/#history) for the newest pre-release, and use `uv run --with "mcp==2.0.0a3"` for one-off commands. The pin matters while v2 is in pre-release: an unpinned install resolves to the latest stable v1.x, which this README does not describe. Check [PyPI](https://pypi.org/project/mcp/#history) for the newest pre-release, and use `uv run --with "mcp==2.0.0b1"` for one-off commands.
## A server in 15 lines ## A server in 15 lines

8
docs/index.md
View file

@ -21,21 +21,21 @@ Python 3.10+.
=== "uv" === "uv"
```bash ```bash
uv add "mcp[cli]==2.0.0a3" uv add "mcp[cli]==2.0.0b1"
``` ```
=== "pip" === "pip"
```bash ```bash
pip install "mcp[cli]==2.0.0a3" pip install "mcp[cli]==2.0.0b1"
``` ```
The `[cli]` extra gives you the `mcp` command; you'll want it for development. The `[cli]` extra gives you the `mcp` command; you'll want it for development.
!!! warning "Pin the version while v2 is in alpha" !!! warning "Pin the version while v2 is in beta"
Installers never select a pre-release unless you name one, so an unpinned `uv add "mcp[cli]"` Installers never select a pre-release unless you name one, so an unpinned `uv add "mcp[cli]"`
gives you the latest **v1.x** release, which this documentation does not describe. Check gives you the latest **v1.x** release, which this documentation does not describe. Check
[PyPI](https://pypi.org/project/mcp/#history) for the newest alpha before you copy the line [PyPI](https://pypi.org/project/mcp/#history) for the newest beta before you copy the line
above. See [Installation](installation.md) for the details. above. See [Installation](installation.md) for the details.
## Example ## Example

10
docs/installation.md
View file

@ -2,27 +2,27 @@
The Python SDK is on PyPI as [`mcp`](https://pypi.org/project/mcp/). It requires **Python 3.10+**. The Python SDK is on PyPI as [`mcp`](https://pypi.org/project/mcp/). It requires **Python 3.10+**.
These docs describe **v2**, which is in alpha, so the version pin is not optional yet: These docs describe **v2**, which is in beta, so the version pin is not optional yet:
=== "uv" === "uv"
```bash ```bash
uv add "mcp[cli]==2.0.0a3" uv add "mcp[cli]==2.0.0b1"
``` ```
=== "pip" === "pip"
```bash ```bash
pip install "mcp[cli]==2.0.0a3" pip install "mcp[cli]==2.0.0b1"
``` ```
!!! warning "Why the pin" !!! warning "Why the pin"
Installers never select a pre-release unless you name one, so an unpinned `uv add "mcp[cli]"` Installers never select a pre-release unless you name one, so an unpinned `uv add "mcp[cli]"`
gives you the latest **v1.x** release, which these docs do not describe. Check the gives you the latest **v1.x** release, which these docs do not describe. Check the
[release history](https://pypi.org/project/mcp/#history) for the newest alpha before you copy [release history](https://pypi.org/project/mcp/#history) for the newest beta before you copy
the line above. the line above.
The same applies to one-off commands: `uv run --with "mcp==2.0.0a3" ...`, not `uv run --with mcp ...`. The same applies to one-off commands: `uv run --with "mcp==2.0.0b1" ...`, not `uv run --with mcp ...`.
If your *package* depends on `mcp`, add a `<2` upper bound (for example `mcp>=1.27,<2`) before If your *package* depends on `mcp`, add a `<2` upper bound (for example `mcp>=1.27,<2`) before
the stable v2 lands so the major version bump doesn't surprise you. the stable v2 lands so the major version bump doesn't surprise you.