docs(style): Strip badges from sidebar via SphinxContentsFilter

Monkeypatch SphinxContentsFilter to raise SkipNode for all badge node
types (_safety_badge_node, _resource_badge_node, _model_badge_node).
This is the same pattern Sphinx uses for visit_image in titles.

Badges stay inside nodes.title for proper heading rendering, but are
stripped during toctree text extraction so the sidebar shows clean
tool names without badge text or emoji leakage.

Add CSS to size badges at 0.5em within h1/h2 headings for medium
button appearance rather than full-scale heading text.

Author: tony

docs/_ext/fastmcp_autodoc.py

@@ -1997,6 +1997,19 @@ def setup(app: Sphinx) -> ExtensionMetadata:
     # CSS
     app.add_css_file("css/fastmcp_autodoc.css")
 
+    # Strip badge nodes from toctree/sidebar title extraction.
+    # SphinxContentsFilter walks title nodes to build toctree text.
+    # Without this, badges inside titles propagate to the sidebar.
+    # This is the same pattern Sphinx uses for visit_image (SkipNode).
+    from sphinx.transforms import SphinxContentsFilter
+
+    def _skip_badge(self: t.Any, node: nodes.Node) -> None:
+        raise nodes.SkipNode
+
+    SphinxContentsFilter.visit__safety_badge_node = _skip_badge  # type: ignore[attr-defined]
+    SphinxContentsFilter.visit__resource_badge_node = _skip_badge  # type: ignore[attr-defined]
+    SphinxContentsFilter.visit__model_badge_node = _skip_badge  # type: ignore[attr-defined]
+
     return {
         "version": "0.1.0",
         "parallel_read_safe": True,

docs/_static/css/fastmcp_autodoc.css

@@ -18,6 +18,18 @@ span.sd-badge[aria-label*="model"] {
     font-family: var(--sd-fontfamily-monospace, monospace);
 }
 
+/* Badge in section headings — medium size, not full h1 scale */
+h1 .sd-badge,
+h2 .sd-badge {
+    font-size: 0.5em;
+    vertical-align: middle;
+}
+
+/* Sidebar: strip background from inline code (tool/resource/model names) */
+.sidebar-tree code.literal {
+    background: none;
+}
+
 /* Field/param table polish — tighter padding */
 .fastmcp-autodoc-table td,
 .fastmcp-autodoc-table th {