from pathlib import Path
from typing import Literal, Any

from mcp.server.fastmcp import FastMCP


class MCPServer:
    """MCP server for serving documentation."""

    mcp_root: Path
    app: FastMCP

    def __init__(self, mcp_root: Path, name: str) -> None: ...

    def _read_json(self, path: Path) -> Any: ...

    def _register_resources(self) -> None: ...

    def _register_tools(self) -> None: ...

    def run(self, transport: Literal["stdio", "sse", "streamable-http"] = ...) -> None:
        """Start the MCP server."""