Add Claude Code agent configuration and GraphQL introspection

- Added KFC (Kent Feature Creator) spec workflow agents for requirements, design, tasks, testing, implementation and evaluation
- Added Claude Code settings configuration for agent workflows
- Added GraphQL introspection query and schema files for Unraid API exploration
- Updated development script with additional debugging and schema inspection capabilities
- Enhanced logging configuration with structured formatting
- Updated pyproject.toml dependencies and uv.lock

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

unraid_mcp/config/logging.py

@@ -1,15 +1,32 @@
 """Logging configuration for Unraid MCP Server.
 
-This module sets up structured logging with console and rotating file handlers
-that can be used consistently across all modules.
+This module sets up structured logging with Rich console and rotating file handlers
+that can be used consistently across all modules and development scripts.
 """
 
 import logging
 import sys
 from logging.handlers import RotatingFileHandler
+from datetime import datetime
+import pytz
+from rich.console import Console
+from rich.logging import RichHandler
+from rich.text import Text
+from rich.panel import Panel
+from rich.align import Align
+from rich.rule import Rule
+
+try:
+    from fastmcp.utilities.logging import get_logger as get_fastmcp_logger
+    FASTMCP_AVAILABLE = True
+except ImportError:
+    FASTMCP_AVAILABLE = False
 
 from .settings import LOG_LEVEL_STR, LOG_FILE_PATH
 
+# Global Rich console for consistent formatting
+console = Console(stderr=True, force_terminal=True)
+
 
 def setup_logger(name: str = "UnraidMCPServer") -> logging.Logger:
     """Set up and configure the logger with console and file handlers.
@@ -31,11 +48,16 @@ def setup_logger(name: str = "UnraidMCPServer") -> logging.Logger:
     # Clear any existing handlers
     logger.handlers.clear()
     
-    # Console Handler
-    console_handler = logging.StreamHandler(sys.stdout)
+    # Rich Console Handler for beautiful output
+    console_handler = RichHandler(
+        console=console,
+        show_time=True,
+        show_level=True,
+        show_path=False,
+        rich_tracebacks=True,
+        tracebacks_show_locals=True
+    )
     console_handler.setLevel(numeric_log_level)
-    console_formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
-    console_handler.setFormatter(console_formatter)
     logger.addHandler(console_handler)
     
     # File Handler with Rotation
@@ -56,6 +78,89 @@ def setup_logger(name: str = "UnraidMCPServer") -> logging.Logger:
     return logger
 
 
+def configure_fastmcp_logger_with_rich():
+    """Configure FastMCP logger to use Rich formatting with Nordic colors."""
+    if not FASTMCP_AVAILABLE:
+        return None
+    
+    # Get numeric log level
+    numeric_log_level = getattr(logging, LOG_LEVEL_STR, logging.INFO)
+    
+    # Get the FastMCP logger
+    fastmcp_logger = get_fastmcp_logger("UnraidMCPServer")
+    
+    # Clear existing handlers
+    fastmcp_logger.handlers.clear()
+    fastmcp_logger.propagate = False
+    
+    # Rich Console Handler
+    console_handler = RichHandler(
+        console=console,
+        show_time=True,
+        show_level=True,
+        show_path=False,
+        rich_tracebacks=True,
+        tracebacks_show_locals=True,
+        markup=True
+    )
+    console_handler.setLevel(numeric_log_level)
+    fastmcp_logger.addHandler(console_handler)
+    
+    # File Handler with Rotation
+    file_handler = RotatingFileHandler(
+        LOG_FILE_PATH, 
+        maxBytes=5*1024*1024, 
+        backupCount=3, 
+        encoding='utf-8'
+    )
+    file_handler.setLevel(numeric_log_level)
+    file_formatter = logging.Formatter(
+        '%(asctime)s - %(name)s - %(levelname)s - %(module)s - %(funcName)s - %(lineno)d - %(message)s'
+    )
+    file_handler.setFormatter(file_formatter)
+    fastmcp_logger.addHandler(file_handler)
+    
+    fastmcp_logger.setLevel(numeric_log_level)
+    
+    # Also configure the root logger to catch any other logs
+    root_logger = logging.getLogger()
+    root_logger.handlers.clear()
+    root_logger.propagate = False
+    
+    # Rich Console Handler for root logger
+    root_console_handler = RichHandler(
+        console=console,
+        show_time=True,
+        show_level=True,
+        show_path=False,
+        rich_tracebacks=True,
+        tracebacks_show_locals=True,
+        markup=True
+    )
+    root_console_handler.setLevel(numeric_log_level)
+    root_logger.addHandler(root_console_handler)
+    
+    # File Handler for root logger
+    root_file_handler = RotatingFileHandler(
+        LOG_FILE_PATH, 
+        maxBytes=5*1024*1024, 
+        backupCount=3, 
+        encoding='utf-8'
+    )
+    root_file_handler.setLevel(numeric_log_level)
+    root_file_handler.setFormatter(file_formatter)
+    root_logger.addHandler(root_file_handler)
+    root_logger.setLevel(numeric_log_level)
+    
+    return fastmcp_logger
+
+
+def setup_uvicorn_logging():
+    """Configure uvicorn and other third-party loggers to use Rich formatting."""
+    # This function is kept for backward compatibility but now delegates to FastMCP
+    return configure_fastmcp_logger_with_rich()
+
+
 def log_configuration_status(logger: logging.Logger) -> None:
     """Log configuration status at startup.
     
@@ -88,5 +193,95 @@ def log_configuration_status(logger: logging.Logger) -> None:
         logger.error(f"Missing required configuration: {config['missing_config']}")
 
 
+# Development logging helpers for Rich formatting
+def get_est_timestamp() -> str:
+    """Get current timestamp in EST timezone with YY/MM/DD format."""
+    est = pytz.timezone('US/Eastern')
+    now = datetime.now(est)
+    return now.strftime("%y/%m/%d %H:%M:%S")
+
+def log_header(title: str):
+    """Print a beautiful header panel with Nordic blue styling."""
+    panel = Panel(
+        Align.center(Text(title, style="bold white")),
+        style="#5E81AC",  # Nordic blue
+        padding=(0, 2),
+        border_style="#81A1C1"  # Light Nordic blue
+    )
+    console.print(panel)
+
+def log_with_level_and_indent(message: str, level: str = "info", indent: int = 0):
+    """Log a message with specific level and indentation."""
+    timestamp = get_est_timestamp()
+    indent_str = "  " * indent
+    
+    # Enhanced Nordic color scheme with more blues
+    level_config = {
+        "error": {"color": "#BF616A", "icon": "❌", "style": "bold"},      # Nordic red
+        "warning": {"color": "#EBCB8B", "icon": "⚠️", "style": ""},       # Nordic yellow
+        "success": {"color": "#A3BE8C", "icon": "✅", "style": "bold"},    # Nordic green
+        "info": {"color": "#5E81AC", "icon": "ℹ️", "style": "bold"},       # Nordic blue (bold)
+        "status": {"color": "#81A1C1", "icon": "🔍", "style": ""},        # Light Nordic blue
+        "debug": {"color": "#4C566A", "icon": "🐛", "style": ""},         # Nordic dark gray
+    }
+    
+    config = level_config.get(level, {"color": "#81A1C1", "icon": "•", "style": ""})  # Default to light Nordic blue
+    
+    # Create beautifully formatted text
+    text = Text()
+    
+    # Timestamp with Nordic blue styling
+    text.append(f"[{timestamp}]", style="#81A1C1")  # Light Nordic blue for timestamps
+    text.append(" ")
+    
+    # Indentation with Nordic blue styling  
+    if indent > 0:
+        text.append(indent_str, style="#81A1C1")
+    
+    # Level icon (only for certain levels)
+    if level in ["error", "warning", "success"]:
+        # Extract emoji from message if it starts with one, to avoid duplication
+        if message and len(message) > 0 and ord(message[0]) >= 0x1F600:  # Emoji range
+            # Message already has emoji, don't add icon
+            pass
+        else:
+            text.append(f"{config['icon']} ", style=config["color"])
+    
+    # Message content
+    message_style = f"{config['color']} {config['style']}".strip()
+    text.append(message, style=message_style)
+    
+    console.print(text)
+
+def log_separator():
+    """Print a beautiful separator line with Nordic blue styling."""
+    console.print(Rule(style="#81A1C1"))
+
+# Convenience functions for different log levels
+def log_error(message: str, indent: int = 0):
+    log_with_level_and_indent(message, "error", indent)
+
+def log_warning(message: str, indent: int = 0):
+    log_with_level_and_indent(message, "warning", indent)
+
+def log_success(message: str, indent: int = 0):
+    log_with_level_and_indent(message, "success", indent)
+
+def log_info(message: str, indent: int = 0):
+    log_with_level_and_indent(message, "info", indent)
+
+def log_status(message: str, indent: int = 0):
+    log_with_level_and_indent(message, "status", indent)
+
 # Global logger instance - modules can import this directly
-logger = setup_logger()
+if FASTMCP_AVAILABLE:
+    # Use FastMCP logger with Rich formatting
+    logger = configure_fastmcp_logger_with_rich()
+    if logger is None:
+        # Fallback to our custom logger if FastMCP configuration fails
+        logger = setup_logger()
+else:
+    # Fallback to our custom logger if FastMCP is not available
+    logger = setup_logger()
+    # Setup uvicorn logging when module is imported
+    setup_uvicorn_logging()

unraid_mcp/server.py

@@ -8,7 +8,7 @@ import sys
 
 from fastmcp import FastMCP
 
-from .config.logging import logger
+from .config.logging import logger, console
 from .config.settings import (
     UNRAID_API_KEY,
     UNRAID_API_URL,