Class UnifiedServerConfig

src/mcp_cli/config/server_models.py:74–176

Unified server configuration supporting both HTTP and STDIO transports. Exactly one of (url, command) must be provided.

class UnifiedServerConfig(BaseModel):
    """Unified server configuration supporting both HTTP and STDIO transports.

    Exactly one of (url, command) must be provided.
    """

    name: str

    # HTTP/SSE transport
    url: str | None = None
    headers: dict[str, str] | None = None
    oauth: OAuthConfig | None = None

    # STDIO transport
    command: str | None = None
    args: list[str] = Field(default_factory=list)
    env: dict[str, str] = Field(default_factory=dict)

    # Common
    disabled: bool = False
    tool_timeout: float | None = Field(
        default=None, description="Per-server tool timeout"
    )
    init_timeout: float | None = Field(
        default=None, description="Per-server init timeout"
    )

    model_config = {"frozen": True}

    @field_validator("name")
    @classmethod
    def validate_name(cls, v: str) -> str:
        """Validate server name."""
        if not v or not v.strip():
            raise ValueError("Server name cannot be empty")
        return v.strip()

    @field_validator("url")
    @classmethod
    def validate_url_format(cls, v: str | None) -> str | None:
        """Validate URL format if provided."""
        if v and not v.startswith(("http://", "https://")):
            raise ValueError("URL must start with http:// or https://")
        return v

    @field_validator("command")
    @classmethod
    def validate_command_not_empty(cls, v: str | None) -> str | None:
        """Validate command is not empty string if provided."""
        if v is not None and not v.strip():
            raise ValueError("Command cannot be empty string")
        return v.strip() if v else None

    def model_post_init(self, __context) -> None:
        """Validate that exactly one of (url, command) is provided."""
        has_url = self.url is not None
        has_command = self.command is not None