pyproject.toml

[project]
name = "mcp"
dynamic = ["version", "dependencies"]
description = "Model Context Protocol SDK"
readme = "README.md"
requires-python = ">=3.10"
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.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Python :: 3.14",
]
[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"
# PEP 517 build isolation fetches [build-system].requires (and transitives) at
# floating-latest with no hash check on every fresh sync; uv does not lock them
# (astral-sh/uv#5190). Pinning here narrows that to known-good versions. Covers
# the workspace builds (hatchling + uv-dynamic-versioning) and the legacy
# setuptools fallback used by the strict-no-cover git dep.
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",
    "tomli>=2.0; python_version < '3.11'",
    "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.0",
    "strict-no-cover",
    "logfire>=3.0.0",
    "opentelemetry-sdk>=1.39.1",
    "blockbuster>=1.5.27",
]
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",
]
# Only `scripts/docs/translations.py translate` calls the Claude API; kept out
# of the default groups so no other environment installs the client (or the
# legacy httpx it depends on). See i18n/README.md.
translate = ["anthropic>=0.121.0"]
codegen = ["datamodel-code-generator==0.57.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.5.0",
    "mcp-client=={{ version }}",
    "mcp-types=={{ version }}",
    "pydantic>=2.12.0",
    "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",
    "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-client/mcp_client",
    "src/mcp-types/mcp_types",
    "tests",
    "docs_src",
    "examples/stories",
    "examples/servers",
    "examples/snippets",
    "examples/clients",
    "scripts/check_client_package.py",
    "scripts/check_client_types.py",
    "scripts/docs/build_config.py",
    "scripts/docs/translations.py",
]
venvPath = "."
venv = ".venv"
# `stories` is a workspace package rooted at examples/; the IDE language server
# does not always pick up the editable-install .pth, so resolve it statically.
extraPaths = ["examples"]
# The FastAPI style of using decorators in tests gives a `reportUnusedFunction` error.
# See https://github.com/microsoft/pyright/issues/7771 for more details.
# TODO(Marcelo): We should remove `reportPrivateUsage = false`. The idea is that we should test the workflow that uses
# those private functions instead of testing the private functions directly. It makes it easier to maintain the code source
# and refactor code that is not public.
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 },
    # Compatibility modules re-export the original module namespaces, including private names.
    { root = "src/mcp/client", reportPrivateUsage = false },
    { root = "src/mcp/shared", reportPrivateUsage = false },
    { root = "src/mcp/os", reportPrivateUsage = false },
]

[tool.ruff]
line-length = 120
target-version = "py310"

[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"]
# The mcp.types package is an alias that mirrors mcp_types namespaces by design.
"src/mcp/types/*.py" = ["F403"]
# Generated by scripts/gen_surface_types.py.
"src/mcp-types/mcp_types/_v*/__init__.py" = ["D212", "E501", "I001", "UP007", "UP037"]
"tests/server/mcpserver/test_func_metadata.py" = ["E501"]
# Inline snapshots of the translation tool's output carry long status/prompt lines verbatim.
"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-client", "src/mcp-types", "examples", "examples/clients/*", "examples/servers/*", "examples/snippets"]

[tool.uv.sources]
mcp = { workspace = true }
mcp-client = { 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
# tests/docs/ imports the docs tooling, top-level modules under scripts/docs/.
pythonpath = ["scripts/docs"]
markers = [
    "requirement(id): links a test to the entry in tests/interaction/_requirements.py it exercises",
]
addopts = """
    --color=yes
    --capture=fd
    -p anyio
    -p examples
"""
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

# https://coverage.readthedocs.io/en/latest/config.html#run
[tool.coverage.run]
branch = true
patch = ["subprocess"]
concurrency = ["multiprocessing", "thread"]
source = ["src", "src/mcp-client/mcp_client", "src/mcp-types/mcp_types", "tests"]
omit = [
    "src/mcp/client/__main__.py",
    "src/mcp-client/mcp_client/client/__main__.py",
    "src/mcp/server/__main__.py",
    "src/mcp-client/mcp_client/os/posix/utilities.py",
    "src/mcp-client/mcp_client/os/win32/utilities.py",
]

# https://coverage.readthedocs.io/en/latest/config.html#report
[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",
]

# https://coverage.readthedocs.io/en/latest/config.html#paths
[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"]
format-command = "ruff format --stdin-filename {filename}"