Args:
    name: The name of the person or entity to greet. Defaults to 'World'.

Returns:
    A greeting message confirming successful MCP communication.

Wraps ``manim-slides convert`` to turn rendered slide assets into an
interactive presentation (e.g., Reveal.js HTML, PDF, or PPTX).

Args:
    scenes: Names of the rendered Scene/Slide classes to include, in order.
    dest: Destination path for the compiled presentation
        (e.g., "presentation.html"). The format is inferred from the
        extension when ``output_format`` is "auto".
    folder: Directory containing the rendered slide assets (default "slides").
    output_format: Conversion format: "auto", "html", "pdf", "pptx", or "zip".
    config: Extra converter options as key/value pairs
        (e.g., {"slide_number": "true"}).
    one_file: Embed all local assets (e.g., videos) into a single output file.
    workspace_dir: Working directory for the conversion. Defaults to the
        ``WORKSPACE_DIR`` environment variable or the current directory.
    timeout: Maximum time in seconds to wait for the conversion.

Returns:
    A JSON string with the conversion status, output destination,
    executed command, and captured stdout/stderr.

Wraps ``manim-slides convert --to html`` with first-class Reveal.js
configuration for themes, transitions, and navigation controls.

Args:
    scenes: Names of the rendered Scene/Slide classes to include, in order.
    dest: Destination path for the exported HTML deck
        (e.g., "presentation.html").
    folder: Directory containing the rendered slide assets (default "slides").
    theme: Reveal.js theme: "black", "white", "league", "beige", "sky",
        "night", "serif", "simple", "solarized", "blood", "moon", or
        "dracula". Defaults to "black".
    transition: Slide transition: "none", "fade", "slide", "convex",
        "concave", or "zoom". Defaults to "none".
    transition_speed: Transition speed: "default", "fast", or "slow".
    controls: Show navigation control arrows in the corner.
    progress: Show a presentation progress bar.
    slide_number: Display the current slide number.
    hash: Add the current slide to the URL hash for deep linking.
    loop: Loop the presentation.
    title: Presentation title used in the browser tab.
    config: Extra Reveal.js converter options as key/value pairs
        (e.g., {"background_color": "white"}).
    one_file: Embed all local assets (e.g., videos) into a single HTML file.
    offline: Download remote Reveal.js assets for offline viewing.
    workspace_dir: Working directory for the conversion. Defaults to the
        ``WORKSPACE_DIR`` environment variable or the current directory.
    timeout: Maximum time in seconds to wait for the conversion.

Returns:
    A JSON string with the export status, output destination,
    executed command, and captured stdout/stderr.

Starts an ephemeral background HTTP server that serves the workspace so the
deck's relative slide assets resolve, and returns a URL that can be opened
in a browser (optionally opening it automatically).

Args:
    dest: Path to the exported HTML deck (e.g., "presentation.html"). Resolved
        relative to ``workspace_dir`` when not absolute.
    workspace_dir: Working directory. Defaults to the ``WORKSPACE_DIR``
        environment variable or the current directory.
    host: Bind address for the server (default "127.0.0.1").
    port: Port to bind. When None, an ephemeral OS-assigned port is used.
    open_browser: When True, attempt to open the URL in the default browser.

Returns:
    A JSON string with the preview URL, bound port, served directory, and
    whether an existing server was reused.

Args:
    port: Port of the server to stop. When omitted, all preview servers
        started by this MCP process are stopped.

Returns:
    A JSON string listing the stopped ports and the number of remaining
    active preview servers.

Reads the slide configuration files (``<scene>.json``) produced by
``manim-slides render`` and returns structured metadata for each scene,
including slide counts, resolution, and per-slide media files.

Args:
    folder: Directory containing the rendered slide assets (default "slides").
    workspace_dir: Working directory. Defaults to the ``WORKSPACE_DIR``
        environment variable or the current directory.

Returns:
    A JSON string listing the discovered scenes and their slide metadata.

Reads the rendered slide configuration for ``scene`` and produces a preview
of the slide at ``slide_index``: an image frame (png/jpg/webp), a video
snippet (mp4), or an animated GIF.

Args:
    scene: Name of the rendered Scene/Slide class to preview.
    slide_index: Zero-based index of the slide within the scene.
    output_format: Preview format: "png", "jpg", "jpeg", "webp", "mp4",
        or "gif". Defaults to "png".
    folder: Directory containing the rendered slide assets (default "slides").
    workspace_dir: Working directory. Defaults to the ``WORKSPACE_DIR``
        environment variable or the current directory.
    timeout: Maximum time in seconds to wait for ffmpeg preview generation.

Returns:
    A JSON string with the preview status, output path, and format.

Writes the provided code to a secure temporary script, renders it with
``manim-slides render`` (headless, no preview popup), and returns the
produced media files. Rendered-frame percentages are streamed to the client
as ``notifications/progress`` updates while rendering is in progress.

Renders are cached by a content hash of ``code``, ``scenes``, and
``quality``: an unchanged request reuses the previously rendered media
instead of re-rendering.

Args:
    code: Python source code defining one or more Manim Scene/Slide classes.
    scenes: Names of the Scene/Slide classes to render. If omitted or empty,
        all scenes in the file are rendered.
    quality: Render quality: "l" (low), "m" (medium), "h" (high),
        "p" (2K), or "k" (4K). Defaults to "l".
    media_dir: Directory where rendered media is stored. Defaults to the
        ``WORKSPACE_DIR`` environment variable or a temporary directory.
    timeout: Maximum time in seconds to wait for rendering.
    use_cache: When True, reuse previously rendered media for unchanged
        requests instead of re-rendering. Defaults to True.

Returns:
    A JSON string with the render status, produced media file paths,
    executed command, and captured stdout/stderr. A cache hit sets
    ``cached`` to True and omits the command.