Improve code organization in everything-server

Add descriptive section headers and logical grouping to improve readability:
- Group tools by category (simple, complex, async, error handling)
- Add explanatory comments for each section
- Maintain single-file structure for reference implementation

This makes it easier to understand the different features being demonstrated
without changing any functionality.

Author: felixweinberger

examples/servers/everything-server/mcp_everything_server/server.py

@@ -53,6 +53,9 @@
 
 # ===== TOOLS =====
 
+# --- Simple Content Tools ---
+# Tools that return a single content type (text, image, audio)
+
 
 @mcp.tool()
 def test_simple_text() -> str:
@@ -72,6 +75,10 @@ def test_audio_content() -> list[AudioContent]:
     return [AudioContent(type="audio", data=TEST_AUDIO_BASE64, mimeType="audio/wav")]
 
 
+# --- Complex Content Tools ---
+# Tools with embedded resources or multiple content types
+
+
 @mcp.tool()
 def test_embedded_resource() -> list[EmbeddedResource]:
     """Tests embedded resource content response"""
@@ -104,6 +111,10 @@ def test_multiple_content_types() -> list[TextContent | ImageContent | EmbeddedR
     ]
 
 
+# --- Async Tools ---
+# Tools that demonstrate async operations, logging, progress, sampling, and elicitation
+
+
 @mcp.tool()
 async def test_tool_with_logging(ctx: Context[ServerSession, None]) -> str:
     """Tests tool that emits log messages during execution"""
@@ -133,12 +144,6 @@ async def test_tool_with_progress(ctx: Context[ServerSession, None]) -> str:
     return str(progress_token)
 
 
-@mcp.tool()
-def test_error_handling() -> str:
-    """Tests error response handling"""
-    raise RuntimeError("This tool intentionally returns an error for testing")
-
-
 class SamplingInput(BaseModel):
     prompt: str = Field(description="The prompt to send to the LLM")
 
@@ -189,8 +194,20 @@ async def test_elicitation(message: str, ctx: Context[ServerSession, None]) -> s
         return f"Elicitation not supported or error: {str(e)}"
 
 
+# --- Error Handling Tools ---
+# Tools that test error handling behavior
+
+
+@mcp.tool()
+def test_error_handling() -> str:
+    """Tests error response handling"""
+    raise RuntimeError("This tool intentionally returns an error for testing")
+
+
 # ===== RESOURCES =====
 
+# Static and dynamic resources demonstrating text, binary, templates, and subscriptions
+
 
 @mcp.resource("test://static-text")
 def static_text_resource() -> str:
@@ -222,6 +239,8 @@ def watched_resource() -> str:
 
 # ===== PROMPTS =====
 
+# Prompts demonstrating simple text, arguments, embedded resources, and images
+
 
 @mcp.prompt()
 def test_simple_prompt() -> list[UserMessage]:
@@ -269,6 +288,8 @@ def test_prompt_with_image() -> list[UserMessage]:
 
 # ===== CUSTOM REQUEST HANDLERS =====
 
+# Handlers for logging level control, resource subscriptions, and completion
+
 
 def setup_custom_handlers():
     """Set up custom request handlers for logging and completion."""