Class MCPConfig

src/mcp_cli/config/models.py:145–201

Complete MCP configuration - clean, immutable, type-safe. This is the source of truth loaded from config files. RuntimeConfig wraps this with CLI/env overrides.

class MCPConfig(BaseModel):
    """Complete MCP configuration - clean, immutable, type-safe.

    This is the source of truth loaded from config files.
    RuntimeConfig wraps this with CLI/env overrides.
    """

    # Provider/Model defaults (no more magic strings!)
    default_provider: str = DEFAULT_PROVIDER
    default_model: str = DEFAULT_MODEL

    # UI (theme names validated by chuk-term)
    theme: str = DEFAULT_THEME  # default|dark|light|minimal|terminal
    verbose: bool = DEFAULT_VERBOSE

    # Configurations
    timeouts: TimeoutConfig = Field(default_factory=TimeoutConfig)
    tools: ToolConfig = Field(default_factory=ToolConfig)
    token_storage: TokenStorageConfig = Field(default_factory=TokenStorageConfig)

    # Servers - kept as dict for flexibility but typed
    # Use alias to support both 'servers' and 'mcpServers' from config files
    servers: dict[str, Any] = Field(default_factory=dict, alias="mcpServers")

    model_config = {"frozen": True, "populate_by_name": True}

    @classmethod
    async def load_async(cls, config_path: Path) -> MCPConfig:
        """Async load from file (future-proof for async I/O)."""
        import asyncio
        import json

        if not config_path.exists():
            return cls()

        # Use asyncio for file I/O
        loop = asyncio.get_event_loop()
        data = await loop.run_in_executor(None, config_path.read_text)
        parsed = json.loads(data)

        return cls.model_validate(parsed)  # type: ignore[no-any-return]

    @classmethod
    def load_sync(cls, config_path: Path) -> MCPConfig:
        """Synchronous load (for backward compat during transition)."""
        import json

        if not config_path.exists():
            return cls()

        data = json.loads(config_path.read_text())
        return cls.model_validate(data)  # type: ignore[no-any-return]

    @classmethod
    def load_from_file(cls, config_path: Path) -> MCPConfig:
        """Alias for load_sync for backward compatibility."""
        return cls.load_sync(config_path)