v4.2.1

Fixed

• Workspace Cache Locking: Improved lock file handling to prevent persistent deadlocks
  • Increased lock retry delay from 50ms to 100ms for better stability
  • Added automatic stale lock file cleanup after maximum retry attempts
  • Implemented recursive retry mechanism with infinite loop protection
  • Enhanced error messaging and logging for lock acquisition failures
  • Resolves issue where crashed processes could leave persistent lock files blocking new hub instances

v4.2.0

Added

• VS Code Configuration Compatibility: Full support for .vscode/mcp.json configuration format
  • Support for "servers" key alongside existing "mcpServers" key
  • VS Code-style environment variable syntax: ${env:VARIABLE_NAME}
  • VS Code predefined variables: ${workspaceFolder}, ${userHome}, ${pathSeparator}, ${workspaceFolderBasename}, ${cwd}, ${/}
  • VS Code input variables via MCP_HUB_ENV: support for ${input:variable-id} syntax
  • JSON5 support for config files: comments and trailing commas now allowed
  • Seamless migration path: existing .vscode/mcp.json files work directly with MCP Hub

Enhanced

• Configuration System: Enhanced environment variable resolution with VS Code compatibility
  • Proper priority system: predefined variables → process.env → MCP_HUB_ENV
  • Predefined variables available for placeholder resolution but not passed to server environments
  • Comprehensive test coverage for all VS Code variable types and scenarios

v4.1.1

Added

• Real-time Workspace Lifecycle Tracking: Enhanced workspace cache with detailed hub state management
  • Workspace states: active (hub running with connections) and shutting_down (no connections, shutdown timer active)
  • Real-time connection count tracking for all active hubs
  • Shutdown timer information including start time and delay duration
  • Automatic state transitions when connections are added/removed
  • Live updates via SSE events enable immediate UI feedback on workspace changes

Enhanced

• Workspace Cache: Extended workspace entries with lifecycle metadata

  • Added state, activeConnections, shutdownStartedAt, and shutdownDelay fields
  • Improved cache update methods for atomic state management
  • Better integration between SSEManager and WorkspaceCacheManager

• SSE System: Enhanced real-time communication

  • SSEManager now updates workspace cache on connection changes
  • Automatic workspace state updates when shutdown timers start/cancel
  • Async connection handling for better cache integration

v4.1.0

Added

• Workspace Management: Global workspace cache to track active hub instances across different working directories

  • New /api/workspaces endpoint to list all active workspace instances
  • Real-time workspace updates via new workspaces_updated SSE subscription event
  • XDG-compliant workspace cache storage (~/.local/state/mcp-hub/workspaces.json)
  • Automatic cleanup of stale workspace entries

• Multi-Configuration File Support: Enhanced configuration system with intelligent merging

  • CLI now accepts multiple --config arguments: --config global.json --config project.json
  • Later configuration files override earlier ones with smart merging rules
  • Missing configuration files are gracefully skipped
  • Enhanced file watching for all specified configuration files

• Global Environment Variable Injection: MCP_HUB_ENV environment variable support

  • Parse JSON string from MCP_HUB_ENV and inject key-value pairs into all MCP server environments
  • Useful for passing shared secrets, tokens, or configuration to all servers
  • Server-specific env fields always override global values

Enhanced

• Health Endpoint: Now includes comprehensive workspace information showing current workspace and all active instances
• Configuration Management: Enhanced ConfigManager with robust array-based config path handling
• File Watching: Improved configuration file monitoring across multiple files with better change detection
• Error Handling: Enhanced error handling and logging throughout the workspace management system
• Updated all dependencies to latest versions for improved security and performance

v4.0.0

Breaking Changes

• Marketplace Migration: Migrated from Cline marketplace API to MCP Registry system
  • Marketplace API response now returns servers instead of items
  • Server objects use new schema with id instead of mcpId
  • Field names changed: githubStars → stars, createdAt → lastCommit
  • New registry endpoint: https://ravitemer.github.io/mcp-registry/registry.json
  • Server details now include readmeContent fetched directly from GitHub repositories

Changed

• Cache System Overhaul: Restructured cache format for better performance
  • Cache TTL reduced from 24 hours to 1 hour for more frequent updates
  • New cache structure: { registry, lastFetchedAt, serverDocumentation }
  • Better error handling and fallback mechanisms for network failures

Added

• Enhanced Test Coverage: Comprehensive test suite for new registry system
  • Tests for new data structures and API responses
  • Network error handling and fallback testing
  • Documentation fetching and caching tests

v3.7.2

Added

• Enhanced cwd field support: Placeholders in cwd are now resolved just like other fields, and changing cwd in config triggers server restart.

v3.7.1

Added

• cwd field for stdio servers: can specify a cwd (current working directory) for stdio-based servers in the config.
  • Example:

    {
      "server-name": {
        "cwd": "/home/ubuntu/server-dir/",
        "command": "npm",
        "args": ["start"]
      }
    }

v3.7.0

Added

• XDG Base Directory Specification Support: Migrated from hardcoded ~/.mcp-hub paths to XDG-compliant directories
  • Marketplace cache now uses XDG data directory (~/.local/share/mcp-hub/cache)
  • Logs now use XDG state directory (~/.local/state/mcp-hub/logs)
  • OAuth storage now uses XDG data directory (~/.local/share/mcp-hub/oauth)
  • Backward compatibility maintained for existing ~/.mcp-hub installations
  • New XDG paths utility module with automatic fallback logic

Enhanced

• Updated documentation to reflect new XDG-compliant path structure
• Improved file organization following Linux filesystem standards

v3.6.0

Added

• Unified MCP Server Endpoint: New /mcp endpoint that exposes all capabilities from managed servers
  • Single endpoint for all MCP clients (Claude Desktop, Cline, etc.) to connect to
  • Automatic namespacing of capabilities to prevent conflicts between servers
  • Real-time capability synchronization when servers are added/removed/restarted
  • Support for tools, resources, resource templates, and prompts from all servers

Enhanced

• Added comprehensive health monitoring with MCP endpoint statistics
• Improved capability change detection with efficient key-based comparison
• Added detailed documentation explaining the unified server approach

Changed

• Refactored capability synchronization for better performance
• Simplified capability change detection by removing complex deep comparisons

v3.5.0

Added

• Manual OAuth callback endpoint for improved headless server support
• Support for manual authorization flow in remote/headless environments