mcpmu

mcpmu — MCP Server Manager

mcpmu is a multiplexing MCP server manager. You configure MCP servers once in mcpmu, then expose them as a single unified MCP endpoint to any agent (Claude Code, Codex, Cursor, Windsurf, etc.).

Installing mcpmu

First check if mcpmu is already installed:

which mcpmu

If not installed, install via Homebrew (preferred) or Go:

Homebrew (macOS/Linux):

brew tap Bigsy/tap && brew install mcpmu

From source (requires Go):

go install github.com/Bigsy/mcpmu/cmd/mcpmu@latest

Registering mcpmu as an MCP Server

After installing mcpmu, register it so your agent can use all mcpmu-managed servers through a single endpoint.

Claude Code:

claude mcp add mcpmu -- mcpmu serve --stdio

Codex:

codex mcp add mcpmu -- mcpmu serve --stdio

OpenCode (global config ~/.config/opencode/config.json, or project-level opencode.json):

{
  "mcp": {
    "mcpmu": {
      "type": "local",
      "command": ["mcpmu", "serve", "--stdio"]
    }
  }
}

Any MCP config JSON (Cursor, Windsurf, etc.):

{
  "mcpmu": {
    "command": "mcpmu",
    "args": ["serve", "--stdio"]
  }
}

With a specific namespace:

claude mcp add work -- mcpmu serve --stdio --namespace work
codex mcp add work -- mcpmu serve --stdio --namespace work

OpenCode (namespace-specific):

{
  "mcp": {
    "work": {
      "type": "local",
      "command": ["mcpmu", "serve", "--stdio", "--namespace", "work"]
    }
  }
}

With management tools (lets the agent add/remove servers via MCP):

claude mcp add mcpmu -- mcpmu serve --stdio --expose-manager-tools

With a compressed tool surface (saves context on large namespaces):

claude mcp add mcpmu -- mcpmu serve --stdio --compress medium

With --compress, tools/list returns only three wrapper tools — list_tools, get_tool_schema, and invoke_tool — with a compact one-line-per-tool listing embedded in invoke_tool's description. The agent fetches full schemas on demand and calls tools through invoke_tool, so it only pays context for the schemas it actually uses. Levels: low (full descriptions), medium (first sentence — recommended), high (argument names only), max (tool names only). Works with --http too. mcpmu tool permissions still apply to the real target tool; note that client-side per-tool rules only ever see invoke_tool, so prefer mcpmu permissions when compression is on.