docs: Update documentation for MCP catalog browser feature

- Updated README with MCP catalog browser features
- Added v1.0.15 changelog entry with catalog details
- Enhanced MCP_INTEGRATION.md with catalog usage guide
- Updated user-guide.md with catalog installation steps

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

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

Author: anubissbe

CHANGELOG.md

@@ -7,23 +7,66 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.15] - 2025-06-10
+
+### Added
+- MCP Catalog Browser with tab-based UI
+  - Browse available MCP servers from Docker Hub catalog
+  - Search servers by name and description
+  - Filter by categories (storage, docker, shell, kubernetes, etc.)
+  - One-click installation with auto-start capability
+  - Real-time metrics showing download counts and ratings
+  - Pagination support for large catalogs
+  - Smart auto-configuration based on server type
+
+### Changed
+- Updated MCPServers component to use tabbed interface
+- Added "Installed Servers" and "Browse Catalog" tabs
+- Enhanced README with MCP catalog features
+
+### Fixed
+- Added missing `volumes` field to MCPConfig for proper volume mounting
+
+## [1.0.14] - 2025-06-10
+
+### Fixed
+- Updated MCP server configurations to match Docker Hub catalog structure
+- Changed to correct mcp/ namespace for all predefined servers
+- Added catalog browsing reference link
+
+## [1.0.13] - 2025-06-10
+
+### Fixed
+- Increased SSH idle timeout from 10 to 60 minutes
+- Improved SSH connection stability to prevent disconnections
+- Added tunnel status checking before attempting reconnection
+- Enhanced settings persistence logging
+
+## [1.0.12] - 2025-06-10
+
+### Fixed
+- Fixed settings persistence issue across extension reinstalls
+- Resolved SSH disconnection when switching Docker Desktop tabs
+- Improved MCP server loading with better error handling
+- Added comprehensive debugging for MCP server initialization
+
+## [1.0.11] - 2025-06-10
+
 ### Added
 - MCP (Model Context Protocol) Toolkit Integration
   - New MCP Servers tab in the UI for managing MCP servers on remote hosts
-  - Pre-configured MCP server templates (Filesystem, Docker, Shell, Git, Database, Web)
+  - Pre-configured MCP server templates (Filesystem, Docker, Shell)
   - Backend API endpoints for MCP server lifecycle management
   - SSH adapter for executing MCP operations on remote hosts
   - Comprehensive type definitions for MCP entities
   - Real-time server status monitoring
   - Secure SSH tunneling for MCP connections
   - Container-based isolation for each MCP server
-  - Architecture documentation for MCP integration
 
-### Changed
-- Updated README with MCP feature documentation
-- Enhanced user guide with MCP usage instructions
-- Extended API reference with MCP endpoints
-- Updated development guide with MCP component information
+### Fixed
+- Resolved Jest security vulnerability by updating to v30.0.0
+- Updated Node.js to 22.13 and Go to 1.24.0
+- Improved TypeScript type definitions
 
 ## [1.0.10] - 2025-06-09
 

README.md

@@ -98,9 +98,11 @@
 - Volumes: browse, inspect, cleanup
 
 🤖 **MCP Toolkit Integration**
-- Run MCP servers on remote hosts
+- Browse and install from MCP catalog
+- One-click installation with auto-start
 - Pre-configured server templates
 - Filesystem, Docker, Shell access
+- Search and filter MCP servers
 - Secure SSH tunneling for MCP
 
 🔄 **Smart Auto-refresh**
@@ -230,21 +232,33 @@ C:\Users\<username>\.ssh\id_rsa.pub
 ### MCP Toolkit Integration
 The extension now supports running MCP (Model Context Protocol) servers on remote Docker hosts, enabling AI assistants to interact with remote systems securely.
 
+#### 🆕 MCP Catalog Browser (v1.0.15+)
+- **Browse Available Servers**: Explore the MCP catalog with 8+ server types
+- **Search & Filter**: Find servers by name, description, or category
+- **One-Click Install**: Install any MCP server with a single click
+- **Auto-Configuration**: Smart configuration based on server type
+- **Real-time Metrics**: See download counts and ratings
+- **Categories**: Browse by storage, docker, shell, kubernetes, database, git, monitoring, AI/LLM
+
 #### Available MCP Server Types
 - **Filesystem Access**: Read/write or read-only access to remote files
 - **Docker Management**: Control containers, images, and networks via MCP
 - **Shell Access**: Execute commands with configurable restrictions
+- **Kubernetes**: Manage Kubernetes clusters and resources
+- **Database Access**: Connect to PostgreSQL, MySQL, MongoDB
 - **Git Repository**: Work with Git repositories on remote hosts
-- **Database Access**: Connect to PostgreSQL databases
-- **Web Browser**: Browse and interact with web applications
+- **Monitoring**: System metrics, logs, and alerts
+- **AI/LLM Integration**: Connect to Claude, GPT, and local models
 
 #### MCP Features
+- Browse and install from the MCP catalog
 - Pre-configured server templates for quick deployment
 - One-click server creation and management
 - Secure SSH tunneling for all MCP connections
 - Real-time server status monitoring
 - Automatic port assignment and management
 - Container-based isolation for each MCP server
+- Custom naming for installed servers
 
 ## Configuration
 

docs/MCP_INTEGRATION.md

@@ -40,12 +40,36 @@ Docker Desktop Extension
         └── Tool Containers
 ```
 
+## MCP Catalog Browser (v1.0.15+)
+
+The extension now includes a built-in MCP catalog browser that allows users to discover and install MCP servers with a single click.
+
+### Features
+
+- **Browse Catalog**: Explore 8+ MCP server types with descriptions and metadata
+- **Search & Filter**: Find servers by name, description, or category
+- **One-Click Install**: Install any server directly from the catalog
+- **Auto-Configuration**: Smart configuration based on server type
+- **Real-time Metrics**: View download counts, star ratings, and tags
+
+### Available Categories
+
+- **Storage**: Filesystem access, volume management
+- **Docker**: Container and image management
+- **Shell**: Command execution environments
+- **Kubernetes**: K8s cluster management
+- **Database**: PostgreSQL, MySQL, MongoDB connectors
+- **Git**: Repository operations
+- **Monitoring**: Metrics and observability
+- **AI/LLM**: AI model integrations
+
 ## MCP Server Types
 
 1. **Filesystem MCP Server**
    - Access remote filesystem
    - File operations (read, write, list)
    - Directory navigation
+   - Configurable root path and permissions
 
 2. **Docker MCP Server**
    - Container management
@@ -79,24 +103,39 @@ Docker Desktop Extension
    - Read-only mode support
    - Audit logging
 
-## Implementation Plan
-
-### Phase 1: Core Infrastructure
-- [ ] MCP server container definition
-- [ ] Basic SSH tunnel for MCP
-- [ ] Server lifecycle management
-
-### Phase 2: UI Integration
-- [ ] MCP server selection UI
-- [ ] Configuration interface
-- [ ] Status monitoring
-
-### Phase 3: Tool Integration
-- [ ] Filesystem tools
-- [ ] Docker tools
-- [ ] Shell access
-
-### Phase 4: Advanced Features
-- [ ] Custom server support
-- [ ] Multi-server management
-- [ ] Performance optimization
+## Using the MCP Catalog
+
+### Installing from Catalog
+
+1. Navigate to the **MCP Servers** page
+2. Click the **Browse Catalog** tab
+3. Search or filter to find desired servers
+4. Click **Install** on any server
+5. (Optional) Provide a custom name
+6. Click **Install & Start**
+
+### Managing Installed Servers
+
+1. Switch to the **Installed Servers** tab
+2. View all running MCP servers
+3. Start/Stop servers with one click
+4. Delete servers when no longer needed
+
+## Implementation Status
+
+### ✅ Completed Features
+- MCP server container definition
+- SSH tunnel management for MCP
+- Server lifecycle management (create, start, stop, delete)
+- MCP server selection UI with catalog browser
+- Configuration interface with auto-configuration
+- Real-time status monitoring
+- Filesystem, Docker, and Shell server support
+- Multi-server management
+- One-click installation from catalog
+
+### 🚧 Planned Features
+- Real Docker Hub MCP catalog API integration
+- Custom server template creation
+- Advanced permission management
+- Performance monitoring dashboard

docs/user-guide.md

@@ -63,21 +63,34 @@ The Networks tab provides:
 
 The MCP Servers tab allows you to run Model Context Protocol servers on remote Docker hosts, enabling AI assistants to interact with your remote systems.
 
-#### Creating an MCP Server
+#### Installing from the MCP Catalog (v1.0.15+)
 
 1. Navigate to the "MCP Servers" tab
-2. Click "New Server"
-3. Choose from pre-configured templates:
+2. Click the "Browse Catalog" tab
+3. Browse or search for MCP servers:
+   - Use the search bar to find servers by name or description
+   - Filter by category (storage, docker, shell, kubernetes, etc.)
+   - View download counts and ratings
+4. Click "Install" on any server
+5. Optionally provide a custom name
+6. Click "Install & Start" to deploy
+
+#### Creating an MCP Server Manually
+
+1. Navigate to the "MCP Servers" tab
+2. Stay on the "Installed Servers" tab
+3. Click "New Server"
+4. Choose from pre-configured templates:
    - **Filesystem Access**: Browse and edit files on the remote host
-   - **Filesystem (Read-Only)**: Safe read-only file access
    - **Docker Management**: Control Docker via MCP
    - **Shell Access**: Execute bash commands
-   - **Restricted Shell**: Limited command execution for safety
+   - **Kubernetes**: Manage K8s clusters
+   - **Database Access**: PostgreSQL, MySQL, MongoDB
    - **Git Repository**: Work with Git repos
-   - **PostgreSQL Database**: Database access
-   - **Web Browser**: Web interaction capabilities
-4. Optionally customize the server name
-5. Click "Create" to deploy the server
+   - **Monitoring**: System metrics and logs
+   - **AI/LLM Integration**: Connect to AI models
+5. Optionally customize the server name
+6. Click "Create" to deploy the server
 
 #### Managing MCP Servers