[project]

name = "mcp"

dynamic = ["version", "dependencies"]

description = "Model Context Protocol SDK"

readme = "README.md"

requires-python = ">=3.11"

authors = [{ name = "Model Context Protocol a Series of LF Projects, LLC." }]

maintainers = [

{ name = "David Soria Parra", email = "davidsp@anthropic.com" },

{ name = "Marcelo Trylesinski", email = "marcelotryle@gmail.com" },

{ name = "Max Isbey", email = "maxisbey@anthropic.com" },

{ name = "Felix Weinberger", email = "fweinberger@anthropic.com" },

]

keywords = ["mcp", "llm", "automation"]

license = { text = "MIT" }

classifiers = [

"Development Status :: 5 - Production/Stable",

"Intended Audience :: Developers",

"License :: OSI Approved :: MIT License",

"Programming Language :: Python :: 3",

"Programming Language :: Python :: 3.11",

"Programming Language :: Python :: 3.12",

"Programming Language :: Python :: 3.13",

"Programming Language :: Python :: 3.14",

"Programming Language :: Python :: 3.15",

]

[project.optional-dependencies]

rich = ["rich>=13.9.4"]

cli = ["typer>=0.16.0", "python-dotenv>=1.0.0"]

[project.scripts]

mcp = "mcp.cli:app [cli]"

[tool.uv]

default-groups = ["dev", "docs"]

required-version = ">=0.9.5"

build-constraint-dependencies = [

"hatchling==1.29.0",

"uv-dynamic-versioning==0.14.0",

"dunamai==1.26.1",

"jinja2==3.1.6",

"markupsafe==3.0.3",

"packaging==26.1",

"pathspec==1.0.4",

"pluggy==1.6.0",

"tomlkit==0.14.0",

"trove-classifiers==2026.1.14.14",

"setuptools==82.0.1",

]

[dependency-groups]

dev = [

# We add mcp[cli] so `uv sync` considers the extras.

"mcp[cli]",

"mcp-example-stories",

# pydantic-settings is used only by examples (simple-auth, mcpserver/text_me);

# keep it reachable for pyright, which covers examples/servers.

"pydantic-settings>=2.5.2",

"pyright>=1.1.400",

"pytest>=8.4.0",

"ruff>=0.8.5",

"trio>=0.26.2",

"pytest-flakefinder>=1.1.0",

"pytest-xdist>=3.6.1",

"pytest-examples>=0.0.14",

"pytest-pretty>=1.2.0",

"inline-snapshot>=0.23.0",

"dirty-equals>=0.9.0",

"coverage[toml]>=7.10.7,<=7.13",

"pillow>=12.3; python_version >= '3.15'",

"pillow>=12.0; python_version < '3.15'",

"strict-no-cover",

"logfire>=3.0.0",

"opentelemetry-sdk>=1.39.1",

"blockbuster>=1.5.29; python_version >= '3.15'",

"blockbuster>=1.5.27; python_version < '3.15'",

]

docs = [

# Zensical is the Material team's successor to MkDocs; it natively

# re-implements search, glightbox and mkdocstrings but runs no arbitrary

# MkDocs plugins or hooks, so the API reference (formerly gen-files +

# literate-nav) and llms.txt (formerly a hook) are generated by the

# standalone scripts under scripts/docs/. See scripts/docs/build.sh.

# 0.0.48 fixed relative/scoped cross-references for mkdocstrings-python

# (which the mkdocstrings config in mkdocs.yml relies on) but broke

# search; 0.0.50 fixes it. The toolchain is pinned exactly: Zensical is

# pre-1.0 and the build guards key on its rendering behavior, so bumps

# should be deliberate.

"zensical==0.0.50",

# Zensical's mkdocstrings compatibility layer targets the mkdocstrings 1.x /

# mkdocstrings-python 2.0.5+ API (griffe 2 / griffelib); the older

# mkdocstrings 0.30 / python 2.0.1 line renders API pages with an

# unregistered-autorefs KeyError under Zensical.

"mkdocstrings==1.0.4",

"mkdocstrings-python==2.0.5",

# scripts/docs/build_config.py, llms_txt.py and translations.py read

# mkdocs.yml directly; translations.py also drives Zensical's own Markdown

# stack (its `markdown`/`pymdownx` dependencies) to compute heading ids.

"pyyaml>=6.0.2",

# gen_ref_pages.py imports griffe directly. griffelib is not a typo: it is

# griffe's successor distribution (same author) and still imports as

# `griffe`; the old `griffe` distribution is the incompatible 1.x line.

"griffelib==2.1.0",

]

translate = ["anthropic>=0.121.0"]

codegen = ["datamodel-code-generator==0.81.0"]

[build-system]

requires = ["hatchling", "uv-dynamic-versioning"]

build-backend = "hatchling.build"

[tool.hatch.version]

source = "uv-dynamic-versioning"

[tool.uv-dynamic-versioning]

vcs = "git"

style = "pep440"

bump = true

[tool.hatch.metadata.hooks.uv-dynamic-versioning]

dependencies = [

# anyio < 4.10 triggers a compile-time SyntaxWarning on Python 3.14 (PEP 765,

# "'return' in a 'finally' block"); for stdio servers it lands on the child's

# stderr (agronholm/anyio#816, fixed in 4.10).

"anyio>=4.10; python_version >= '3.14'",

"anyio>=4.9; python_version < '3.14'",

"httpx2>=2.10.0",

"mcp-types=={{ version }}",

"pydantic>=2.14.0; python_version >= '3.15'",

"pydantic>=2.12.0; python_version < '3.15'",

"starlette>=0.48.0; python_version >= '3.14'",

"starlette>=0.27; python_version < '3.14'",

"python-multipart>=0.0.9",

"sse-starlette>=3.0.0",

"uvicorn>=0.31.1; sys_platform != 'emscripten'",

"jsonschema>=4.20.0",

"pywin32>=312; sys_platform == 'win32' and python_version >= '3.15'",

"pywin32>=311; sys_platform == 'win32' and python_version < '3.15'",

"pyjwt[crypto]>=2.10.1",

"typing-extensions>=4.13.0",

"typing-inspection>=0.4.1",

"opentelemetry-api>=1.28.0",

]

[project.urls]

Homepage = "https://modelcontextprotocol.io"

Documentation = "https://py.sdk.modelcontextprotocol.io/"

Repository = "https://github.com/modelcontextprotocol/python-sdk"

Issues = "https://github.com/modelcontextprotocol/python-sdk/issues"

[tool.hatch.build.targets.wheel]

packages = ["src/mcp"]

[tool.pyright]

typeCheckingMode = "strict"

include = [

"src/mcp",

"src/mcp-types/mcp_types",

"tests",

"docs_src",

"examples/stories",

"examples/servers",

"examples/snippets",

"examples/clients",

"scripts/docs/build_config.py",

"scripts/docs/translations.py",

]

venvPath = "."

venv = ".venv"

extraPaths = ["examples"]

executionEnvironments = [

{ root = "tests", extraPaths = [

".",

"examples",

"scripts/docs",

], reportUnusedFunction = false, reportPrivateUsage = false },

{ root = "examples/stories", extraPaths = [

"examples",

], reportUnusedFunction = false },

# The `mcp-example-stories` editable install puts `examples/` on sys.path,

# which defeats pyright's auto-detection of `simple-auth/` as a package

# root (it's the one server example that imports itself by absolute name).

{ root = "examples/servers", extraPaths = [

"examples/servers/simple-auth",

], reportUnusedFunction = false },

# docs_src/ holds the complete, runnable code examples included into docs/*.md.

# Decorated (@mcp.tool/...) module-level functions are never called by name.

{ root = "docs_src", reportUnusedFunction = false },

]

[tool.ruff]

line-length = 120

target-version = "py311"

[tool.ruff.lint]

select = [

"C4", # flake8-comprehensions

"C90", # mccabe

"D212", # pydocstyle: multi-line docstring summary should start at the first line

"E", # pycodestyle

"F", # pyflakes

"I", # isort

"PERF", # Perflint

"UP", # pyupgrade

"TID251", # https://docs.astral.sh/ruff/rules/banned-api/

]

ignore = ["PERF203"]

[tool.ruff.lint.flake8-tidy-imports.banned-api]

"pydantic.RootModel".msg = "Use `pydantic.TypeAdapter` instead."

"pydantic.root_model.RootModel".msg = "Use `pydantic.TypeAdapter` instead."

[tool.ruff.lint.mccabe]

max-complexity = 24 # Default is 10

[tool.ruff.lint.per-file-ignores]

"__init__.py" = ["F401"]

"src/mcp/types/*.py" = ["F403"]

"src/mcp-types/mcp_types/_v*/__init__.py" = ["D212", "E501", "I001", "UP007", "UP037"]

"tests/server/mcpserver/test_func_metadata.py" = ["E501"]

"tests/docs/test_translations.py" = ["E501"]

"tests/shared/test_progress_notifications.py" = ["PLW0603"]

[tool.ruff.lint.pylint]

allow-magic-value-types = ["bytes", "float", "int", "str"]

max-args = 23 # Default is 5

max-branches = 23 # Default is 12

max-returns = 13 # Default is 6

max-statements = 102 # Default is 50

[tool.uv.workspace]

members = ["src/mcp-types", "examples", "examples/clients/*", "examples/servers/*", "examples/snippets"]

[tool.uv.sources]

mcp = { workspace = true }

mcp-example-stories = { workspace = true }

mcp-types = { workspace = true }

strict-no-cover = { git = "https://github.com/pydantic/strict-no-cover" }

[tool.pytest.ini_options]

log_cli = true

xfail_strict = true

pythonpath = ["scripts/docs"]

markers = [

"requirement(id): links a test to the entry in tests/interaction/_requirements.py it exercises",

]

addopts = """

filterwarnings = [

"error",

# pywin32 internal deprecation warning

"ignore:getargs.*The 'u' format is deprecated:DeprecationWarning",

# SEP-2577 deprecates the roots/sampling/logging methods; the SDK still calls

# them internally (e.g. `ctx.debug` -> `log` -> `send_log_message`), so the

# advisory warning is silenced. Tests asserting it opt back in with pytest.warns.

"ignore:.*is deprecated as of 2026-07-28 \\(SEP-2577\\).:mcp.MCPDeprecationWarning",

# 2026-07-28 restricts progress to server->client; the client send path is

# advisory-deprecated and a handful of tests still exercise it.

"ignore:Client-to-server progress is deprecated as of 2026-07-28.*:mcp.MCPDeprecationWarning",

# 2026-07-28 drops ping; Client.send_ping() is advisory-deprecated and the

# legacy interaction/transport tests still drive it.

"ignore:ping is removed as of 2026-07-28.*:mcp.MCPDeprecationWarning",

# CI and scripts/test set PYTHONWARNDEFAULTENCODING=1, so "error" rejects any text I/O

# of ours that omits encoding=; pytest-examples' own unguarded text I/O isn't ours.

"ignore:'encoding' argument not specified:EncodingWarning:pytest_examples",

]

[tool.markdown.lint]

default = true

MD004 = false # ul-style - Unordered list style

MD007.indent = 2 # ul-indent - Unordered list indentation

MD013 = false # line-length - Line length

MD029 = false # ol-prefix - Ordered list item prefix

MD033 = false # no-inline-html Inline HTML

MD041 = false # first-line-heading/first-line-h1

MD046 = false # indented-code-blocks

MD059 = false # descriptive-link-text

[tool.coverage.run]

branch = true

patch = ["subprocess"]

concurrency = ["multiprocessing", "thread"]

source = ["src", "src/mcp-types/mcp_types", "tests"]

omit = [

"src/mcp/client/__main__.py",

"src/mcp/server/__main__.py",

"src/mcp/os/posix/utilities.py",

"src/mcp/os/win32/utilities.py",

]

[tool.coverage.report]

fail_under = 100

skip_covered = true

show_missing = true

ignore_errors = true

precision = 2

exclude_also = [

"pragma: lax no cover",

"@overload",

"raise NotImplementedError",

]

[tool.coverage.paths]

source = [

"src/",

"/home/runner/work/python-sdk/python-sdk/src/",

'D:\a\python-sdk\python-sdk\src',

]

[tool.inline-snapshot]

default-flags = ["disable"]

default-flags-tui = ["disable"]

format-command = "ruff format --stdin-filename {filename}"