@@ -35,6 +35,8 @@ func IsDockerMCPAvailable() bool {
3535 return err == nil
3636}
3737
38+// DockerMCPAvailabilityCached returns the cached Docker MCP availability and
39+// whether the cached value is still fresh.
3840func DockerMCPAvailabilityCached() (available bool, known bool) {
3941 dockerMCPAvailabilityCache.mu.Lock()
4042 defer dockerMCPAvailabilityCache.mu.Unlock()
@@ -48,6 +50,7 @@ func DockerMCPAvailabilityCached() (available bool, known bool) {
4850 return dockerMCPAvailabilityCache.available, true
4951}
5052
53+// RefreshDockerMCPAvailability refreshes and caches Docker MCP availability.
5154func RefreshDockerMCPAvailability() bool {
5255 available := IsDockerMCPAvailable()
5356 dockerMCPAvailabilityCache.mu.Lock()
@@ -67,6 +70,7 @@ func (c *Config) IsDockerMCPEnabled() bool {
6770 return exists
6871}
6972
73+// DockerMCPConfig returns the default Docker MCP stdio configuration.
7074func DockerMCPConfig() MCPConfig {
7175 return MCPConfig{
7276 Type: MCPStdio,
@@ -76,6 +80,8 @@ func DockerMCPConfig() MCPConfig {
7680 }
7781}
7882
83+// PrepareDockerMCPConfig validates Docker MCP availability and stages the
84+// Docker MCP configuration in memory.
7985func (s *ConfigStore) PrepareDockerMCPConfig() (MCPConfig, error) {
8086 if !IsDockerMCPAvailable() {
8187 return MCPConfig{}, fmt.Errorf("docker mcp is not available, please ensure docker is installed and 'docker mcp version' succeeds")
@@ -89,6 +95,8 @@ func (s *ConfigStore) PrepareDockerMCPConfig() (MCPConfig, error) {
8995 return mcpConfig, nil
9096}
9197
98+// PersistDockerMCPConfig persists a previously prepared Docker MCP
99+// configuration to the global config file.
92100func (s *ConfigStore) PersistDockerMCPConfig(mcpConfig MCPConfig) error {
93101 if err := s.SetConfigField(ScopeGlobal, "mcp."+DockerMCPName, mcpConfig); err != nil {
94102 return fmt.Errorf("failed to persist docker mcp configuration: %w", err)