"""Shared logging utilities for MCP server.""" import logging import sys from loguru import logger class LoguruInterceptHandler(logging.Handler): """Intercept standard logging and route to Loguru. This handler bridges the standard Python logging module with Loguru, ensuring all logs (from both systems) use the same formatting. """ def emit(self, record: logging.LogRecord) -> None: try: level = logger.level(record.levelname).name except ValueError: level = str(record.levelno) logger.opt(exception=record.exc_info).log(level, record.getMessage()) def intercept_standard_logging() -> None: """Configure standard logging to route through Loguru. This should be called after Loguru is configured to ensure all standard logging calls are intercepted and formatted consistently. """ logging.basicConfig(handlers=[LoguruInterceptHandler()], level=0, force=True) def setup_logging(level: str = "INFO", stdio_mode: bool = False) -> None: """Configure logging with Loguru.""" logger.remove() # In stdio mode, use stderr (stdout is reserved for JSON-RPC) sink = sys.stderr if stdio_mode else sys.stdout if level == "DEBUG": format_str = "{level: <8} | {time:HH:mm:ss} | {name}:{line} | {message}" else: format_str = ( "{level: <8} | {time:HH:mm:ss} | {message}" ) logger.add( sink, format=format_str, level=level, colorize=(not stdio_mode), diagnose=(level == "DEBUG"), ) intercept_standard_logging()