Cannot find reference 'MCPServer' in 'mcp.server.mcpserver' in Quickstart code

[jesuspb2]

Initial Checks

• I confirm that I'm using the latest version of MCP Python SDK
• I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue

Description

The Quickstart example code references MCPServer from mcp.server.mcpserver, but this class cannot be found, resulting in an import error.

Expected Behavior:
The MCPServer class should be available for import from mcp.server.mcpserver as shown in the Quickstart documentation.

Actual Behavior:
The IDE cannot locate the MCPServer class in the specified module, preventing the example from running.

Steps to Reproduce:

1. Follow the Quickstart guide
2. Copy the example code that imports MCPServer
3. Attempt to run the code
4. Observe the import error

Environment:

• Python version: 3.13.5
• MCP library version: 1.26.0
• IDE: PyCharm 2025.3.2
• OS: macOS

Example Code

from mcp.server.mcpserver import MCPServer
# Create an MCP server
mcp = MCPServer("Demo")

Python & MCP Python SDK

- Python version: 3.13.5
- MCP library version: 1.26.0

[samsond]

I can confirm I’m seeing similar behavior on mcp[cli]==1.26.0 (Python 3.11.12 on macOS).

I investigated this issue and found that MCPServer appears to have been introduced in commit 65c614e (Jan 25, 2026), which renamed FastMCP to MCPServer.

Based on my investigation, it seems this change has not been released to PyPI yet. The latest release tag I can find is v1.26.0, which appears to predate this rename.

Maintainers: I'm not familiar with the release process, correct me if I've misunderstood the versioning. The documentation references MCPServer, but it's not available in the PyPI package I installed.

[sabarigireeson-glitch]

I also faced the same issue yesterday, upon checking and referring I found

FastMCP is the latest API available in the released PyPI package.
MCPServer exists in the GitHub main branch (it’s a rename of FastMCP) but has not been released to PyPI yet.
As of mcp==1.26.0, the correct import is:

from mcp.server.fastmcp import FastMCP

The documentation currently reflects unreleased changes.

[maxisbey]

Hey everyone! The errors here are because the main branch of the python-sdk points to the not yet released v2 rework of the MCP Python SDK. This contains breaking changes compared to previously released versions, and much of the documentation will not work with old versions.

So the documentation you see when you go to https://github.com/modelcontextprotocol/python-sdk is specifically for the upcoming v2 version, and there's a warning right at the top of the README file which says this, although to be fair it is easy to miss.

If you want to see documentation for v1, please head here: https://github.com/modelcontextprotocol/python-sdk/tree/v1.x