• Repository

Meta

• License: MIT License (MIT)
• Author: Anthropic, PBC.
• Maintainer: David Soria Parra
• Tags automation , git , llm , mcp
• Requires: Python >=3.10
• Provides-Extra: cli , rich , ws

Classifiers

• Development Status
  • 4 - Beta
• Intended Audience
  • Developers
• License
  • OSI Approved :: MIT License
• Programming Language
  • Python :: 3
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: 3.14

MCP Python SDK

This documents v1.x, the stable release line of the MCP Python SDK. v2 is in alpha.

v2 pre-releases are published to PyPI as 2.0.0aN. Installers never select a pre-release unless you opt in (for example pip install mcp==2.0.0a1), so v1.x users are unaffected. If your package depends on mcp, add a <2 upper bound to your version constraint (for example mcp>=1.27,<2) before the stable v2 release lands. See the v2 documentation and the migration guide for what's changing.

v1.x remains recommended for production use. It is in maintenance mode and continues to receive critical bug fixes and security patches.

Table of Contents

• MCP Python SDK
  • Overview
  • Installation
  • Quickstart
  • What is MCP?
  • Documentation
  • Contributing
  • License

Overview

The Model Context Protocol allows applications to provide context for LLMs in a standardized way, separating the concerns of providing context from the actual LLM interaction. This Python SDK implements the full MCP specification, making it easy to:

• Build MCP clients that can connect to any MCP server
• Create MCP servers that expose resources, prompts and tools
• Use standard transports like stdio, SSE, and Streamable HTTP
• Handle all MCP protocol messages and lifecycle events

Installation

Adding MCP to your python project

We recommend using uv to manage your Python projects.

If you haven't created a uv-managed project yet, create one:

uvinitmcp-server-demo
cdmcp-server-demo

Then add MCP to your project dependencies:

uvadd"mcp[cli]"

Alternatively, for projects using pip for dependencies:

pipinstall"mcp[cli]"

Running the standalone MCP development tools

To run the mcp command with uv:

uvrunmcp

Quickstart

Let's create a simple MCP server that exposes a calculator tool and some data:

"""
FastMCP quickstart example.

Run from the repository root:
 uv run examples/snippets/servers/fastmcp_quickstart.py
"""

frommcp.server.fastmcpimport FastMCP

# Create an MCP server
mcp = FastMCP("Demo", json_response=True)


# Add an addition tool
@mcp.tool()
defadd(a: int, b: int) -> int:
"""Add two numbers"""
 return a + b


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
defget_greeting(name: str) -> str:
"""Get a personalized greeting"""
 return f"Hello, {name}!"


# Add a prompt
@mcp.prompt()
defgreet_user(name: str, style: str = "friendly") -> str:
"""Generate a greeting prompt"""
 styles = {
 "friendly": "Please write a warm, friendly greeting",
 "formal": "Please write a formal, professional greeting",
 "casual": "Please write a casual, relaxed greeting",
 }

 return f"{styles.get(style,styles['friendly'])} for someone named {name}."


# Run with streamable HTTP transport
if __name__ == "__main__":
 mcp.run(transport="streamable-http")

Full example: examples/snippets/servers/fastmcp_quickstart.py

You can install this server in Claude Code and interact with it right away. First, run the server:

uvrun--withmcpexamples/snippets/servers/fastmcp_quickstart.py

Then add it to Claude Code:

claudemcpadd--transporthttpmy-serverhttp://localhost:8000/mcp

Alternatively, you can test it with the MCP Inspector. Start the server as above, then in a separate terminal:

npx-y@modelcontextprotocol/inspector

In the inspector UI, connect to http://localhost:8000/mcp.

What is MCP?

The Model Context Protocol (MCP) lets you build servers that expose data and functionality to LLM applications in a secure, standardized way. Think of it like a web API, but specifically designed for LLM interactions. MCP servers can:

• Expose data through Resources (think of these sort of like GET endpoints; they are used to load information into the LLM's context)
• Provide functionality through Tools (sort of like POST endpoints; they are used to execute code or otherwise produce a side effect)
• Define interaction patterns through Prompts (reusable templates for LLM interactions)
• And more!

Documentation

• Building Servers -- tools, resources, prompts, logging, completions, sampling, elicitation, transports, ASGI mounting
• Writing Clients -- connecting to servers, using tools/resources/prompts, display utilities
• Authorization -- OAuth 2.1, token verification, client authentication
• Low-Level Server -- direct handler registration for advanced use cases
• Protocol Features -- MCP primitives, server capabilities
• Testing -- in-memory transport testing with pytest
• API Reference
• Experimental Features (Tasks)
• Model Context Protocol documentation
• Model Context Protocol specification
• Officially supported servers

Contributing

We are passionate about supporting contributors of all levels of experience and would love to see you get involved in the project. See the contributing guide to get started.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Verified details

These details have been verified by PyPI

Project links

• Issues
• Repository

GitHub Statistics

Maintainers

👁 Avatar for dsp from gravatar.com
dsp 👁 Avatar for jspahrsummers from gravatar.com
jspahrsummers 👁 Avatar for Kludex from gravatar.com
Kludex 👁 Avatar for maxisbey from gravatar.com
maxisbey

Unverified details

These details have not been verified by PyPI

Project links

• Documentation
• Homepage

• Download URL: mcp-1.28.0.tar.gz
• Upload date: Jun 16, 2026
• Size: 636.0 kB
• Tags: Source
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.12

Hashes for mcp-1.28.0.tar.gz

Algorithm	Hash digest
SHA256	559d3f9943674cafbe5744c5d3794f3237e8b47f9bbc58e20c0fad680d8487c2
MD5	490e6a6c465b1d3d2c96b0d8fb9b30d2
BLAKE2b-256	c1ee94c6c50ffc5b5cf4737052275d11b57367f32d1a8516e31dcd60591b3916

See more details on using hashes here.

• Download URL: mcp-1.28.0-py3-none-any.whl
• Upload date: Jun 16, 2026
• Size: 222.0 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.13.12

Hashes for mcp-1.28.0-py3-none-any.whl

Algorithm	Hash digest
SHA256	9c1e7cf3a9125557e418ecd4fed8e9adddce81b0dfdae4d6601d700f5beb71a4
MD5	b845ac18365f9417fcabda1503852377
BLAKE2b-256	2ee14c1dc1fbb688641a712d34650c3d58bbbdcb314ddb75bc5817bbf33515a4

See more details on using hashes here.