mcp-logger-utils

# MCP Logger Utils - Enhanced Documentation A comprehensive logging and utility package for MCP (Model Context Protocol) servers with production-ready features. ## Features ### Core Features - 🔍 **Smart Logging** - Automatic truncation of large data structures - 🛡️ **PII Protection** - Automatic detection and redaction of sensitive data - 🔄 **Circular Reference Protection** - Safe logging of complex objects - 📊 **Performance Monitoring** - Track slow operations automatically - 🚦 **Rate Limiting** - Prevent log spam - 🧪 **Testing Utilities** - Capture logs in tests - 🔧 **Debug Tools** - Process management for MCP servers - 🎯 **Error Deduplication** - Avoid repeated error messages - 📝 **Structured Logging** - Add request IDs and context - ⚙️ **Runtime Configuration** - Change settings without restart ## Installation ```bash pip install mcp-logger-utils ``` ## Quick Start ### Basic Usage ```python from mcp_logger_utils import MCPLogger # Create logger instance logger = MCPLogger("my-mcp-server") # Use it like any logger logger.info("Server starting up...") logger.debug("Debug information") logger.success("Operation completed successfully ✅") logger.error("Something went wrong") ``` ### Available Logging Methods All standard loguru methods are available with type hints: ```python logger.trace("Most detailed logging") logger.debug("Debug information") logger.info("General information") logger.success("Success messages ✅") logger.warning("Warning messages") logger.error("Error messages") logger.critical("Critical issues") logger.exception("Log with traceback") ``` ## Enhanced Features ### 1. PII Protection Automatically redact sensitive information: ```python # Enable PII redaction (enabled by default) logger = MCPLogger("my-server", enable_pii_redaction=True) # These will be automatically redacted logger.info("User email: john.doe@example.com") # Logs: "User email: j***@***.***" logger.info("Phone: +1-555-123-4567") # Logs: "Phone: ***-***-**…