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 <fweinberger@anthropic.com> * docs: add pre-commit install guide on CONTRIBUTING.md (modelcontextprotocol#995) Co-authored-by: Felix Weinberger <fweinberger@anthropic.com> * 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 <inna@anthropic.com> * Unpack settings in FastMCP (modelcontextprotocol#1198) * chore: Remove unused prompt_manager.py file (modelcontextprotocol#1229) Co-authored-by: Tapan Chugh <tapanc@cs.washington.edu> * Improved supported for ProtectedResourceMetadata (modelcontextprotocol#1235) Co-authored-by: Paul Carleton <paulcarletonjr@gmail.com> * 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 <marcelotryle@gmail.com> * fix: prevent async generator cleanup errors in StreamableHTTP transport (modelcontextprotocol#1271) Co-authored-by: David Soria Parra <167242713+dsp-ant@users.noreply.github.com> * chore: uncomment .idea/ in .gitignore (modelcontextprotocol#1287) Co-authored-by: Claude <noreply@anthropic.com> * 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 <marcelotryle@gmail.com> Co-authored-by: Felix Weinberger <fweinberger@anthropic.com> * Added Audio to FastMCP (modelcontextprotocol#1130) * fix: avoid uncessary retries in OAuth authenticated requests (modelcontextprotocol#1206) Co-authored-by: Felix Weinberger <fweinberger@anthropic.com> * 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 <vinhsannguyen91@gmail.com> Co-authored-by: Felix Weinberger <fweinberger@anthropic.com> Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com> * 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 <noreply@anthropic.com> * 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 <3823880+felixweinberger@users.noreply.github.com> * fix: allow elicitations accepted without content (modelcontextprotocol#1285) Co-authored-by: Olivier Schiavo <olivier.schiavo@wengo.com> * 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 <paulcarletonjr@gmail.com> Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com> Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com> * Fastmcp logging progress example (modelcontextprotocol#1270) Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com> * feat: add paginated list decorators for prompts, resources, and tools (modelcontextprotocol#1286) Co-authored-by: Claude <noreply@anthropic.com> * 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 <tapanc@cs.washington.edu> Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com> * Implementation of SEP 973 - Additional metadata + icons support (modelcontextprotocol#1357) * Merge upstream/main with custom filtering --------- Signed-off-by: San Nguyen <vinhsannguyen91@gmail.com> Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com> Co-authored-by: yurikunash <143175350+yurikunash@users.noreply.github.com> Co-authored-by: Pamela Fox <pamela.fox@gmail.com> Co-authored-by: Inna Harper <inna.hrpr@gmail.com> Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com> Co-authored-by: Ian Davenport <49379192+davenpi@users.noreply.github.com> Co-authored-by: Dagang Wei <functicons@gmail.com> Co-authored-by: Felix Weinberger <fweinberger@anthropic.com> Co-authored-by: Stanley Law <stanleylkal@gmail.com> Co-authored-by: Luca Chang <131398524+LucaButBoring@users.noreply.github.com> Co-authored-by: leweng <leweng@nvidia.com> Co-authored-by: Clare Liguori <liguori@amazon.com> Co-authored-by: lukacf <luka@peltarion.com> Co-authored-by: ihrpr <inna@anthropic.com> Co-authored-by: Tapan Chugh <chugh.tapan@gmail.com> Co-authored-by: Tapan Chugh <tapanc@cs.washington.edu> Co-authored-by: Yann Jouanin <4557670+yannj-fr@users.noreply.github.com> Co-authored-by: Paul Carleton <paulcarletonjr@gmail.com> Co-authored-by: Sreenath Somarajapuram <somarajapuram@gmail.com> Co-authored-by: Omer Korner <omerkorner@gmail.com> Co-authored-by: joesavage-silabs <159480754+joesavage-silabs@users.noreply.github.com> Co-authored-by: Gregory L <gregory.linford@mistral.ai> Co-authored-by: David Soria Parra <167242713+dsp-ant@users.noreply.github.com> Co-authored-by: Moustapha Ebnou <155577789+mous222@users.noreply.github.com> Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: Jerome <jerome@anthropic.com> Co-authored-by: xavier <84836280+dragonier23@users.noreply.github.com> Co-authored-by: keurcien <keurcien.luu@gmail.com> Co-authored-by: Tim Esler <tim.esler@gmail.com> Co-authored-by: San Nguyen <22189661+sandangel@users.noreply.github.com> Co-authored-by: Justin Wang <89049861+justin-yi-wang@users.noreply.github.com> Co-authored-by: jess <jessachandler@gmail.com> Co-authored-by: Peter Alexander <pja@anthropic.com> Co-authored-by: Reid Geyer <12072650+reidg44@users.noreply.github.com> Co-authored-by: Eleftheria Stein-Kousathana <eleftheria.kousathana@gmail.com> Co-authored-by: Christian Clauss <cclauss@me.com> Co-authored-by: pchoudhury22 <pchoudhury22@apple.com> Co-authored-by: owengo <owengo@users.noreply.github.com> Co-authored-by: Olivier Schiavo <olivier.schiavo@wengo.com> Co-authored-by: Steve Billings <billings.steve@gmail.com> Co-authored-by: Mike Salvatore <mike.s.salvatore@gmail.com>

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)}")

Uh oh!

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!

4 participants