enable API ref left nav autogen (#4)

* Fix griffe warnings in mkdocs documentation generation

- Remove **extra parameter documentation that doesn't match function signature in fastmcp/server.py
- Fix malformed docstring structure in func_metadata.py by moving content to proper Note section
- Correct parameter name mismatch in lowlevel/server.py lifespan function docstring

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* autgenerate API reference nav

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: mmacy

docs/api.md

@@ -1,5 +1,3 @@
 # MCP Server
 
 This is the MCP Server implementation in Python.
-
-It only contains the [API Reference](api.md) for the time being.

docs/index.md

@@ -12,7 +12,6 @@ site_url: https://modelcontextprotocol.github.io/python-sdk
 
 nav:
   - Home: index.md
-  - API Reference: api.md
 
 theme:
   name: "material"
@@ -118,3 +117,5 @@ plugins:
             - url: https://docs.python.org/3/objects.inv
             - url: https://docs.pydantic.dev/latest/objects.inv
             - url: https://typing-extensions.readthedocs.io/en/latest/objects.inv
+  - api-autonav:
+      modules: ['src/mcp']

mkdocs.yml

@@ -62,6 +62,7 @@ dev = [
 ]
 docs = [
     "mkdocs>=1.6.1",
+    "mkdocs-api-autonav>=0.3.1",
     "mkdocs-glightbox>=0.4.0",
     "mkdocs-material[imaging]>=9.5.45",
     "mkdocstrings-python>=1.12.2",

pyproject.toml

@@ -1275,7 +1275,6 @@ async def log(
             level: Log level (debug, info, warning, error)
             message: Log message
             logger_name: Optional logger name
-            **extra: Additional structured data to include
         """
         await self.request_context.session.send_log_message(
             level=level,

src/mcp/server/fastmcp/server.py

@@ -185,11 +185,12 @@ def func_metadata(
         func: The function to convert to a pydantic model
         skip_names: A list of parameter names to skip. These will not be included in
             the model.
-        structured_output: Controls whether the tool's output is structured or unstructured
-            - If None, auto-detects based on the function's return type annotation
-            - If True, unconditionally creates a structured tool (return type annotation permitting)
-            - If False, unconditionally creates an unstructured tool
+        structured_output: Controls whether the tool's output is structured or unstructured.
+            If None, auto-detects based on the function's return type annotation.
+            If True, unconditionally creates a structured tool (return type annotation permitting).
+            If False, unconditionally creates an unstructured tool.
 
+    Note:
         If structured, creates a Pydantic model for the function's result based on its annotation.
         Supports various return types:
             - BaseModel subclasses (used directly)

src/mcp/server/fastmcp/utilities/func_metadata.py

@@ -122,7 +122,7 @@ async def lifespan(_: Server[LifespanResultT, RequestT]) -> AsyncIterator[dict[s
     """Default lifespan context manager that does nothing.
 
     Args:
-        server: The server instance this lifespan is managing
+        _: The server instance this lifespan is managing
 
     Returns:
         An empty context object