github-featured/modelcontextprotocol--python-sdk

Files

T

History

Max Isbey ab24c34d89 Address review: keep three anticipated failures out of the crash path, docs sweep

- pre_parse_json leaves a string alone when json.loads refuses it with
  something other than JSONDecodeError (over-long integer, deep nesting),
  so validation rejects it as a bad argument instead of it surfacing as a
  crash with a traceback per request.
- convert_result skips output-schema validation for a returned
  CallToolResult(is_error=True); an error result has no structured content
  to check, and the author's message now reaches the client as written.
- read_resource checks that Resource.read() returned str or bytes, so a
  mistyped custom resource is logged as a crash and answered with -32603
  rather than "Invalid request parameters" with no log record.
- Docs and examples that still said "raise any exception and the model
  reads it" now say ToolError; deprecated.md lists the deprecated
  FuncMetadata helper; docstrings spell out the MCPError carve-out and the
  nested-crash __cause__.
- Two tests tightened: the prompt argument-validation test proves the body
  never ran, and the invalid-types check asserts on validate_arguments.

2026-08-21 16:23:48 +00:00

clients

Pin text I/O to UTF-8 and fail CI on locale-dependent reads/writes (#3296 )

2026-08-16 12:41:53 +01:00

mcpserver

Add mcp.types as a permanent alias for mcp_types (#3190 )

2026-07-27 23:47:04 +01:00

servers

Address review: keep three anticipated failures out of the crash path, docs sweep

2026-08-21 16:23:48 +00:00

snippets

Add mcp.types as a permanent alias for mcp_types (#3190 )

2026-07-27 23:47:04 +01:00

stories

Let Client take StdioServerParameters directly (#3321 )

2026-08-17 14:31:21 +01:00

pyproject.toml

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

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

README.md

docs: restructure into topical sections and add the four most-asked-for pages (#3044 )

2026-07-01 21:06:04 +01: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.
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.