github-featured/modelcontextprotocol--python-sdk

Files

T

History

Max Isbey a05dd3da0c Polish the todos-server example after rebasing onto latest main

Re-verified against the TypeScript reference at its current main: the
missing-capability shape is now a -32021 protocol error on both servers
on 2026-07-28 connections (README fidelity note updated), the TS entry's
protected HTTP wiring is matched by the SDK's streamable HTTP defaults
(noted in server.py), and 2026-era watchers are pointed at the client's
listen() driver. Also renames the module-level task store so the
add_tasks parameter no longer shadows it, folds the brainstorm outcome
union into one alias, types the log threshold as LoggingLevel, and
makes comments and docstrings ASCII-only.

2026-07-16 20:09:33 +00:00

clients

Replace httpx and httpx-sse with httpx2 (#2972 )

2026-07-14 17:05:08 +01:00

mcpserver

Replace httpx and httpx-sse with httpx2 (#2972 )

2026-07-14 17:05:08 +01:00

servers

Polish the todos-server example after rebasing onto latest main

2026-07-16 20:09:33 +00:00

snippets

Replace httpx and httpx-sse with httpx2 (#2972 )

2026-07-14 17:05:08 +01:00

stories

Add Streamable HTTP request body limits (#3095 )

2026-07-16 08:33:32 +02:00

pyproject.toml

Add story-style examples suite (27 stories + harness + CI) (#2957 )

2026-06-26 12:02:27 +02:00

README.md

Add the todos-server reference example

2026-07-16 19:49:07 +00:00

README.md

Python SDK examples

stories/ — the canonical reference. One self-verifying example per protocol feature, each with its own README. Start with stories/tools/; the stories README has the full table and how to run them.
snippets/ — short extracts that were embedded into the v1 README (now on the v1.x branch); superseded by docs_src/, which the docs and README embed today. Retained pending consolidation into stories/.
servers/everything-server/ — the conformance target for the cross-SDK conformance suite. Exercises every server capability in one process.
servers/todos-server/ — the reference server: a small todo board where every server-side feature has a real job, serving both protocol revisions over stdio and Streamable HTTP. A faithful port of the TypeScript SDK's examples/todos-server.
mcpserver/ — single-file v1-era examples retained for the migration guide; superseded by stories/ and slated for removal.
clients/ and the remaining servers/ directories (simple-*, sse-polling-demo, structured-output-lowlevel) — standalone v1-era projects retained pending consolidation into stories/ (the simple-auth pair is still linked from docs/run/authorization.md and docs/client/oauth-clients.md).

For real-world servers see the servers repository.