github-featured/modelcontextprotocol--python-sdk

Files

T

History

Max Isbey 1b74b06753 Tighten comments and docstrings repo-wide

Cut comment and docstring volume roughly in half across src, tests,
examples, and docs_src: removed comments that restate the adjacent code,
leftover development narration, section banners, and self-evident
Args/Returns blocks, and compressed the remaining docstrings to a
Google-style summary line plus only the detail that earns its place.

Kept (and tightened) the load-bearing content: Raises sections,
deprecation and version-availability notes, spec/RFC/issue references,
why-comments for non-obvious decisions, and all coverage pragmas. The
generated mcp_types.v* wire modules are untouched.

2026-06-29 15:10:27 +00:00

__init__.py

Add a pluggable server extension API with MCP Apps (#3003 )

2026-06-29 10:58:05 +01:00

client.py

Tighten comments and docstrings repo-wide

2026-06-29 15:10:27 +00:00

README.md

Add a pluggable server extension API with MCP Apps (#3003 )

2026-06-29 10:58:05 +01:00

server.py

Tighten comments and docstrings repo-wide

2026-06-29 15:10:27 +00:00

README.md

apps

MCP Apps: a tool carries a _meta.ui.resourceUri reference to a ui:// resource that the host renders as an interactive surface. The server opts in via the Apps extension (io.modelcontextprotocol/ui); the client negotiates it by advertising the text/html;profile=mcp-app MIME type.

Run it

# stdio (default — the client spawns the server as a subprocess)
uv run python -m stories.apps.client

# HTTP — the client self-hosts the server on a free port, runs, then tears it down
uv run python -m stories.apps.client --http

What to look at

server.py MCPServer("apps-example", extensions=[apps]) — the extension advertises io.modelcontextprotocol/ui under ServerCapabilities.extensions and contributes the UI-bound tool and its ui:// resource. MCPServer itself never learns about "ui"; it applies a closed set of contributions.
server.py @apps.tool(resource_uri=...) — stamps _meta.ui.resourceUri on the tool; add_html_resource registers the matching ui:// resource at text/html;profile=mcp-app.
server.py client_supports_apps(ctx) — SEP-2133 graceful degradation: a client that did not negotiate Apps gets a text-only result.
client.py Client(target, extensions={...}) — the client advertises Apps support so the server returns the UI-enabled result, then reads the tool's _meta.ui.resourceUri and fetches that resource.

Spec

MCP Apps — extensions · SEP-2133 — extensions capability

README.md

apps

Run it

What to look at

Spec

See also