Download Latest Version v6.2.0 source code.tar.gz (3.9 MB)
Email in envelope

Get an email when there's a new version of MCP Hub

Home / v6.0.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2025-07-18 2.9 kB
0
v6.0.0 source code.tar.gz 2025-07-18 3.9 MB
0
v6.0.0 source code.zip 2025-07-18 4.0 MB
0
Totals: 3 Items   7.9 MB 0

Added

  • ** Workspace-Aware MCP Hub**: project-local configuration support (#148, [#183], [#196], [#200])
  • Smart Project Detection: Automatically detects project boundaries using .mcphub/servers.json, .vscode/mcp.json, .cursor/mcp.json
  • Isolated Hub Instances: Each workspace gets its own mcp-hub process with unique ports (40000-41000 range)
  • Configuration Merging: Project configs automatically override global settings while preserving global servers
  • Automatic Switching: Seamlessly switches between workspace hubs on directory changes (DirChanged events)

  • Dynamic Port Allocation: Hash-based port generation with conflict resolution and custom port assignment support

  • ** Global Environment Variables**: Universal environment injection for all MCP servers (#183)

  • Flexible Configuration: Support for both table and function-based global_env configuration
  • Context-Aware Variables: Function receives workspace context (port, config files, workspace mode)
  • Mixed Format Support: Array-style ("VAR") and hash-style (KEY = "value") entries

  • Automatic Resolution: Environment variables resolved when hub starts with project context

  • 🎨 Enhanced UI Experience: Complete workspace management interface

  • Active Hubs Section: View and manage all running workspace hub instances
  • Grouped Server Display: Servers organized by config source (Global vs Project) with visual indicators
  • Multi-Config Editor: Tab-based interface for editing different config files (global and project)
  • Workspace Actions: Expand/collapse details, kill processes, change directories, view configuration files

Enhanced

  • Directory Change Handling: Proper hub switching when changing directories in Neovim
  • Config File Watching: Enhanced file watching to handle multiple configuration sources
  • Some common expected keymaps like <Cr>, o and <Esc> work along with the l and k keys

Fixed

  • Multi-Project Isolation: Solves the fundamental issue of MCP servers working in wrong project directories
  • Environment Variable Access: Addresses user session variables (like DBUS_SESSION_BUS_ADDRESS) not being available to MCP servers

Migration Guide

Existing configurations work without changes. To enable workspace features:

:::lua
require("mcphub").setup({
  workspace = {
    enabled = true, -- Default: true
    look_for = { ".mcphub/servers.json", ".vscode/mcp.json", ".cursor/mcp.json" },
    reload_on_dir_changed = true,
    port_range = { min = 40000, max = 41000 },
    get_port = nil, -- Optional custom port function
  },
  global_env = {
    "DBUS_SESSION_BUS_ADDRESS", -- Array-style: uses os.getenv()
    API_KEY = os.getenv("API_KEY"), -- Hash-style: explicit value
  }
})
Source: README.md, updated 2025-07-18