Merge pull request #22 from BlackDadd77/copilot/add-md-file-snippet-yml

Configure pymdownx.snippets and add examples documentation

Author: BlackDadd77

docs/examples.md

@@ -0,0 +1,32 @@
+# Code Examples
+
+This page demonstrates various MCP SDK examples using the snippet feature.
+
+## FastMCP Quickstart
+
+Here's a complete quickstart example showing how to create a server with tools, resources, and prompts:
+
+```python title="fastmcp_quickstart.py"
+--8<-- "servers/fastmcp_quickstart.py"
+```
+
+## Basic Tool Example
+
+This example shows how to define simple tools:
+
+```python title="basic_tool.py"
+--8<-- "servers/basic_tool.py"
+```
+
+## Usage
+
+To run any of these examples:
+
+1. Navigate to the `examples/snippets` directory
+2. Run the server using `uv run mcp dev <filename>`
+
+For example:
+```bash
+cd examples/snippets
+uv run mcp dev servers/basic_tool.py
+```

mkdocs.yml

@@ -18,6 +18,7 @@ nav:
       - Low-Level Server: low-level-server.md
       - Authorization: authorization.md
       - Testing: testing.md
+  - Examples: examples.md
   - API Reference: api.md
 
 theme:
@@ -77,7 +78,10 @@ markdown_extensions:
   - pymdownx.critic
   - pymdownx.mark
   - pymdownx.superfences
-  - pymdownx.snippets
+  - pymdownx.snippets:
+      base_path:
+        - examples/snippets
+        - .
   - pymdownx.tilde
   - pymdownx.inlinehilite
   - pymdownx.highlight: