MCP Python SDK

<div align="center">

<strong>Python implementation of the Model Context Protocol (MCP)</strong>

[![PyPI][pypi-badge]][pypi-url]
[![MIT licensed][mit-badge]][mit-url]
[![Python Version][python-badge]][python-url]
[![Documentation][docs-badge]][docs-url]
[![Protocol][protocol-badge]][protocol-url]
[![Specification][spec-badge]][spec-url]

</div>

<!-- TODO(v2): Replace this README with README.v2.md when v2 is released -->

> [!NOTE]
> This README documents v1.x of the MCP Python SDK (the current stable release).
>
> For v1.x code and documentation, see the v1.x branch.
> For the upcoming v2 documentation (pre-alpha, in development on main), see README.v2.md.

<!-- omit in toc -->

Table of Contents

MCP Python SDK

- Overview
- Installation
- Adding MCP to your python project
- Running the standalone MCP development tools
- Quickstart
- What is MCP?
- Core Concepts
- Server
- Resources
- Tools
- Structured Output
- Prompts
- Images
- Context
- Getting Context in Functions
- Context Properties and Methods
- Completions
- Elicitation
- Sampling
- Logging and Notifications
- Authentication
- FastMCP Properties
- Session Properties and Methods
- Request Context Properties
- Running Your Server
- Development Mode
- Claude Desktop Integration
- Direct Execution
- Streamable HTTP Transport
- CORS Configuration for Browser-Based Clients
- Mounting to an Existing ASGI Server
- StreamableHTTP servers
- Basic mounting
- Host-based routing
- Multiple servers with path configuration
- Path configuration at initialization
- SSE servers
- Advanced Usage
- Low-Level Server
- Structured Output Support
- Pagination (Advanced)
- Writing MCP Clients
- [Client

... [truncated — view full README on GitHub]