README - replace code snippets with examples - add lowlevel to snippets #1150

ihrpr · 2025-07-16T08:49:33Z

Part 3:

Low-level server with lifespan
Low-level server basic example
Low-level server structured output

Part 1: #1055
Part 2: #1136
Part 3: #1137

Remaining:

Auth
- Authentication server example
- OAuth client authentication
Remote MCP (streamable Http)
- Streamable HTTP client
- Streamable HTTP server examples
- SSE server mounting examples (just change to mounting )

Kludex · 2025-07-16T10:26:45Z

README.md

+"""Low-level server example showing structured output support.

+This example demonstrates how to use the low-level server API to return
+structured data from tools, with automatic validation against output schemas.
+
+Run from the repository root:
+    uv run examples/snippets/servers/lowlevel/structured_output.py
+"""


Those module docstring seems to be adding a lot of unnecessary content to the README, given that you can run each of those individually.

Kludex · 2025-07-16T10:29:59Z

README.md

+            # WARNING: eval() is dangerous! Use a safe math parser in production
+            result = eval(expression)


I know we have the comment warning people, but maybe we can have an example that doesn't use it?

Agree, maybe something like:

from sympy import sympify ... result = sympify(expression).evalf()

(and the extra dep can be added as uv preamble w/ uv add --script ...py sympy)

just changed an example to weathers, same as we have for high level server API

Kludex · 2025-07-16T10:30:23Z

README.md

        except Exception as e:
            raise ValueError(f"Calculation error: {str(e)}")


Out of scope, but this shouldn't be necessary, since the exception is just bubbled up?

And/or, maybe always raise X() from e for exception chaining

ochafik

Thanks Inna! A few optional suggestions :-)

ochafik · 2025-07-16T13:22:30Z

README.md

    if name != "example-prompt":
        raise ValueError(f"Unknown prompt: {name}")

+    arg1_value = arguments.get("arg1", "default") if arguments else "default"


meganit: arg1_value = (arguments or {}).get("arg1", "default") to say default only once?

ochafik · 2025-07-16T13:28:26Z

README.md

+            # WARNING: eval() is dangerous! Use a safe math parser in production
+            result = eval(expression)


Agree, maybe something like:

from sympy import sympify ... result = sympify(expression).evalf()

(and the extra dep can be added as uv preamble w/ uv add --script ...py sympy)

ochafik · 2025-07-16T13:34:23Z

examples/snippets/servers/lowlevel/lifespan.py

+and cleanup.
+
+Run from the repository root:
+    uv run examples/snippets/servers/lowlevel/lifespan.py


Maybe need uv add --script examples/snippets/servers/lowlevel/lifespan.py mcp first to bake the dep(s) into each of these examples? Otherwise I'm getting:

error: Workspace member `/Users/ochafik/code/modelcontextprotocol-python-sdk/examples/servers/simple-auth-remote` is missing a `pyproject.toml` (matches: `examples/servers/*`)

ochafik · 2025-07-16T13:42:05Z

examples/snippets/servers/lowlevel/structured_output.py

+
+            # low-level server will validate structured output against the tool's
+            # output schema, and automatically serialize it into a TextContent block
+            # for backwards compatibility with pre-2025-06-18 clients.


meganit: I'd maybe switch "automatically" to "additionally" to make it clearer that serialization is in addition to returning structuredContent?

ochafik · 2025-07-16T13:43:32Z

README.md

        except Exception as e:
            raise ValueError(f"Calculation error: {str(e)}")


And/or, maybe always raise X() from e for exception chaining

…ts (modelcontextprotocol#1150)

* Add regression test for stateless request memory cleanup (modelcontextprotocol#1140) * Implement RFC9728 - Support WWW-Authenticate header by MCP client (modelcontextprotocol#1071) * Add streamable HTTP starlette example to Python SDK docs (modelcontextprotocol#1111) * fix markdown error in README in main (modelcontextprotocol#1147) * README - replace code snippets with examples - add lowlevel to snippets (modelcontextprotocol#1150) * README - replace code snippets with examples - streamable http (modelcontextprotocol#1155) * chore: don't allow users to create issues outside the templates (modelcontextprotocol#1163) * Tests(cli): Add coverage for helper functions (modelcontextprotocol#635) * Docs: Update CallToolResult parsing in README (modelcontextprotocol#812) Co-authored-by: Felix Weinberger <[email protected]> * docs: add pre-commit install guide on CONTRIBUTING.md (modelcontextprotocol#995) Co-authored-by: Felix Weinberger <[email protected]> * fix flaky fix-test_streamablehttp_client_resumption test (modelcontextprotocol#1166) * README - replace code snippets with examples -- auth examples (modelcontextprotocol#1164) * Support falling back to OIDC metadata for auth (modelcontextprotocol#1061) * Add CODEOWNERS file for sdk (modelcontextprotocol#1169) * fix flaky test test_88_random_error (modelcontextprotocol#1171) * Make sure `RequestId` is not coerced as `int` (modelcontextprotocol#1178) * Fix: Replace threading.Lock with anyio.Lock for Ray deployment compatibility (modelcontextprotocol#1151) * fix: fix OAuth flow request object handling (modelcontextprotocol#1174) * update codeowners group (modelcontextprotocol#1191) * fix: perform auth server metadata discovery fallbacks on any 4xx (modelcontextprotocol#1193) * server: skip duplicate response on CancelledError (modelcontextprotocol#1153) Co-authored-by: ihrpr <[email protected]> * Unpack settings in FastMCP (modelcontextprotocol#1198) * chore: Remove unused prompt_manager.py file (modelcontextprotocol#1229) Co-authored-by: Tapan Chugh <[email protected]> * Improved supported for ProtectedResourceMetadata (modelcontextprotocol#1235) Co-authored-by: Paul Carleton <[email protected]> * chore: Remove unused variable notification_options (modelcontextprotocol#1238) * Improve README around the Context object (modelcontextprotocol#1203) * fix: allow to pass `list[str]` to `token_endpoint_auth_signing_alg_values_supported` (modelcontextprotocol#1226) * Remove strict validation on `response_modes_supported` member of `OAuthMetadata` (modelcontextprotocol#1243) * Add pyright strict mode on the whole project (modelcontextprotocol#1254) * Consistent casing for default headers Accept and Content-Type (modelcontextprotocol#1263) * Update dependencies and fix type issues (modelcontextprotocol#1268) Co-authored-by: Marcelo Trylesinski <[email protected]> * fix: prevent async generator cleanup errors in StreamableHTTP transport (modelcontextprotocol#1271) Co-authored-by: David Soria Parra <[email protected]> * chore: uncomment .idea/ in .gitignore (modelcontextprotocol#1287) Co-authored-by: Claude <[email protected]> * docs: clarify streamable_http_path configuration when mounting servers (modelcontextprotocol#1172) * feat: Add CORS configuration for browser-based MCP clients (modelcontextprotocol#1059) Co-authored-by: Marcelo Trylesinski <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> * Added Audio to FastMCP (modelcontextprotocol#1130) * fix: avoid uncessary retries in OAuth authenticated requests (modelcontextprotocol#1206) Co-authored-by: Felix Weinberger <[email protected]> * Add PATHEXT to default STDIO env vars in windows (modelcontextprotocol#1256) * fix: error too many values to unpack (expected 2) (modelcontextprotocol#1279) Signed-off-by: San Nguyen <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> * SDK Parity: Avoid Parsing Server Response for non-JsonRPCMessage Requests (modelcontextprotocol#1290) * types: Setting default value for method: Literal (modelcontextprotocol#1292) * changes structured temperature to not deadly (modelcontextprotocol#1328) * Update simple-resource example to use non-deprecated read_resource return type (modelcontextprotocol#1331) Co-authored-by: Claude <[email protected]> * docs: Update README to include link to API docs for modelcontextprotocol#1329 (modelcontextprotocol#1330) * Allow ping requests before initialization (modelcontextprotocol#1312) * Python lint: Ruff rules for pylint and code complexity (modelcontextprotocol#525) * Fix context injection for resources and prompts (modelcontextprotocol#1336) * fix(fastmcp): propagate mimeType in resource template list (modelcontextprotocol#1186) Co-authored-by: Felix Weinberger <[email protected]> * fix: allow elicitations accepted without content (modelcontextprotocol#1285) Co-authored-by: Olivier Schiavo <[email protected]> * Use --frozen in pre-commit config (modelcontextprotocol#1375) * Return HTTP 403 for invalid Origin headers (modelcontextprotocol#1353) * Add test for ProtectedResourceMetadataParsing (modelcontextprotocol#1236) Co-authored-by: Paul Carleton <[email protected]> Co-authored-by: Marcelo Trylesinski <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> * Fastmcp logging progress example (modelcontextprotocol#1270) Co-authored-by: Felix Weinberger <[email protected]> * feat: add paginated list decorators for prompts, resources, and tools (modelcontextprotocol#1286) Co-authored-by: Claude <[email protected]> * Remove "unconditionally" from conditional description (modelcontextprotocol#1289) * Use streamable-http consistently in examples (modelcontextprotocol#1389) * feat: Add SDK support for SEP-1034 default values in elicitation schemas (modelcontextprotocol#1337) Co-authored-by: Tapan Chugh <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> * Implementation of SEP 973 - Additional metadata + icons support (modelcontextprotocol#1357) * Merge upstream/main with custom filtering --------- Signed-off-by: San Nguyen <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> Co-authored-by: yurikunash <[email protected]> Co-authored-by: Pamela Fox <[email protected]> Co-authored-by: Inna Harper <[email protected]> Co-authored-by: Marcelo Trylesinski <[email protected]> Co-authored-by: Ian Davenport <[email protected]> Co-authored-by: Dagang Wei <[email protected]> Co-authored-by: Felix Weinberger <[email protected]> Co-authored-by: Stanley Law <[email protected]> Co-authored-by: Luca Chang <[email protected]> Co-authored-by: leweng <[email protected]> Co-authored-by: Clare Liguori <[email protected]> Co-authored-by: lukacf <[email protected]> Co-authored-by: ihrpr <[email protected]> Co-authored-by: Tapan Chugh <[email protected]> Co-authored-by: Tapan Chugh <[email protected]> Co-authored-by: Yann Jouanin <[email protected]> Co-authored-by: Paul Carleton <[email protected]> Co-authored-by: Sreenath Somarajapuram <[email protected]> Co-authored-by: Omer Korner <[email protected]> Co-authored-by: joesavage-silabs <[email protected]> Co-authored-by: Gregory L <[email protected]> Co-authored-by: David Soria Parra <[email protected]> Co-authored-by: Moustapha Ebnou <[email protected]> Co-authored-by: Max Isbey <[email protected]> Co-authored-by: Claude <[email protected]> Co-authored-by: Jerome <[email protected]> Co-authored-by: xavier <[email protected]> Co-authored-by: keurcien <[email protected]> Co-authored-by: Tim Esler <[email protected]> Co-authored-by: San Nguyen <[email protected]> Co-authored-by: Justin Wang <[email protected]> Co-authored-by: jess <[email protected]> Co-authored-by: Peter Alexander <[email protected]> Co-authored-by: Reid Geyer <[email protected]> Co-authored-by: Eleftheria Stein-Kousathana <[email protected]> Co-authored-by: Christian Clauss <[email protected]> Co-authored-by: pchoudhury22 <[email protected]> Co-authored-by: owengo <[email protected]> Co-authored-by: Olivier Schiavo <[email protected]> Co-authored-by: Steve Billings <[email protected]> Co-authored-by: Mike Salvatore <[email protected]>

add lowlevel to snippets

d6a51f7

ihrpr requested review from Kludex, bhosmer-ant and felixweinberger July 16, 2025 08:49

Kludex previously approved these changes Jul 16, 2025

View reviewed changes

ihrpr mentioned this pull request Jul 16, 2025

README - replace code snippets with examples - streamable http #1155

Merged

1 task

ochafik previously approved these changes Jul 16, 2025

View reviewed changes

change an example to remove exceptions and warnings for parsing

419e8d3

ihrpr dismissed stale reviews from ochafik and Kludex via 419e8d3 July 16, 2025 14:16

ihrpr merged commit 0b4ce00 into main Jul 16, 2025
11 of 13 checks passed

ihrpr deleted the ihrpr/lowlevel-snippet branch July 16, 2025 14:26

ihrpr mentioned this pull request Jul 17, 2025

README - replace code snippets with examples -- auth examples #1164

Merged

saqadri pushed a commit to saqadri/stdio-fixes that referenced this pull request Aug 6, 2025

README - replace code snippets with examples - add lowlevel to snippe…

9fe5dc2

…ts (modelcontextprotocol#1150)

		# WARNING: eval() is dangerous! Use a safe math parser in production
		result = eval(expression)

		except Exception as e:
		raise ValueError(f"Calculation error: {str(e)}")

README - replace code snippets with examples - add lowlevel to snippets #1150

README - replace code snippets with examples - add lowlevel to snippets #1150

Uh oh!

Conversation

ihrpr commented Jul 16, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ochafik left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants