Rebuild the docs around tested examples; shrink README.v2.md to a pitch (#2978)

docs_src/prompts/tutorial001.py

@@ -0,0 +1,9 @@
+from mcp.server import MCPServer
+
+mcp = MCPServer("Code Helper")
+
+
+@mcp.prompt()
+def review_code(code: str) -> str:
+    """Review a piece of code."""
+    return f"Please review this code:\n\n{code}"

docs_src/prompts/tutorial002.py

@@ -0,0 +1,20 @@
+from mcp.server import MCPServer
+from mcp.server.mcpserver.prompts.base import AssistantMessage, Message, UserMessage
+
+mcp = MCPServer("Code Helper")
+
+
+@mcp.prompt()
+def review_code(code: str) -> str:
+    """Review a piece of code."""
+    return f"Please review this code:\n\n{code}"
+
+
+@mcp.prompt()
+def debug_error(error: str) -> list[Message]:
+    """Start a debugging conversation."""
+    return [
+        UserMessage("I'm seeing this error:"),
+        UserMessage(error),
+        AssistantMessage("I'll help debug that. What have you tried so far?"),
+    ]

docs_src/prompts/tutorial003.py

@@ -0,0 +1,16 @@
+from typing import Annotated
+
+from pydantic import Field
+
+from mcp.server import MCPServer
+
+mcp = MCPServer("Code Helper")
+
+
+@mcp.prompt(title="Code review")
+def review_code(
+    code: Annotated[str, Field(description="The code to review.")],
+    language: Annotated[str, Field(description="The language the code is written in.")] = "python",
+) -> str:
+    """Review a piece of code."""
+    return f"Please review this {language} code:\n\n{code}"