refactor: replace lowlevel Server decorators with on_* constructor kwargs (#1985)

examples/snippets/servers/lowlevel/basic.py

@@ -6,32 +6,30 @@ import asyncio
 
 import mcp.server.stdio
 from mcp import types
-from mcp.server.lowlevel import NotificationOptions, Server
-from mcp.server.models import InitializationOptions
-
-# Create a server instance
-server = Server("example-server")
+from mcp.server import Server, ServerRequestContext
 
 
-@server.list_prompts()
-async def handle_list_prompts() -> list[types.Prompt]:
+async def handle_list_prompts(
+    ctx: ServerRequestContext, params: types.PaginatedRequestParams | None
+) -> types.ListPromptsResult:
     """List available prompts."""
-    return [
-        types.Prompt(
-            name="example-prompt",
-            description="An example prompt template",
-            arguments=[types.PromptArgument(name="arg1", description="Example argument", required=True)],
-        )
-    ]
+    return types.ListPromptsResult(
+        prompts=[
+            types.Prompt(
+                name="example-prompt",
+                description="An example prompt template",
+                arguments=[types.PromptArgument(name="arg1", description="Example argument", required=True)],
+            )
+        ]
+    )
 
 
-@server.get_prompt()
-async def handle_get_prompt(name: str, arguments: dict[str, str] | None) -> types.GetPromptResult:
+async def handle_get_prompt(ctx: ServerRequestContext, params: types.GetPromptRequestParams) -> types.GetPromptResult:
     """Get a specific prompt by name."""
-    if name != "example-prompt":
-        raise ValueError(f"Unknown prompt: {name}")
+    if params.name != "example-prompt":
+        raise ValueError(f"Unknown prompt: {params.name}")
 
-    arg1_value = (arguments or {}).get("arg1", "default")
+    arg1_value = (params.arguments or {}).get("arg1", "default")
 
     return types.GetPromptResult(
         description="Example prompt",
@@ -44,20 +42,20 @@ async def handle_get_prompt(name: str, arguments: dict[str, str] | None) -> type
     )
 
 
+server = Server(
+    "example-server",
+    on_list_prompts=handle_list_prompts,
+    on_get_prompt=handle_get_prompt,
+)
+
+
 async def run():
     """Run the basic low-level server."""
     async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
         await server.run(
             read_stream,
             write_stream,
-            InitializationOptions(
-                server_name="example",
-                server_version="0.1.0",
-                capabilities=server.get_capabilities(
-                    notification_options=NotificationOptions(),
-                    experimental_capabilities={},
-                ),
-            ),
+            server.create_initialization_options(),
         )