Skip to content

MCP multiplexer with progressive discovery, parallel batch calls, code execution, and up to 90% token reduction

Notifications You must be signed in to change notification settings

jchip/mcpu

Repository files navigation

MCPU - MCP Unified

Unlimit MCP servers with zero upfront tokens, and up to 90% token reduction

MCPU is an MCP multiplexer (1:N) that manages all your MCP servers for multiple AI Assistants, with progressive discovery, parallel batch calls, code execution, and up to 90% token reduction.

Claude CLI/Desktop ─┐ ┌-> playwright Gemini CLI ──┤ ├-> filesystem Antigravity ──┼-> mcpu ──┼-> memory Cursor ──┤ ├-> tasks OpenAI Codex ─┘ └-> chroma 

Schema Compression Stats

% mcpu-stat MCPU Schema Size Statistics | Server | Tools | MCP Native | MCPU Full | Δ Full | MCPU Compact | Δ Compact | |------------|-------|------------|-----------|--------|--------------|-----------| | chroma | 13 | 11.3 KB | 8.3 KB | -26% | 1.8 KB | -84% | | memory | 9 | 8.3 KB | 2.1 KB | -75% | 1.2 KB | -86% | | playwright | 22 | 11.1 KB | 7.4 KB | -34% | 2.2 KB | -80% | | chrome-dev | 26 | 12.9 KB | 9.3 KB | -28% | 3.5 KB | -73% | | context7 | 2 | 2.9 KB | 2.7 KB | -9% | 833 B | -72% | | tasks | 20 | 25.6 KB | 5.3 KB | -79% | 2.2 KB | -91% | |------------|-------|------------|-----------|--------|--------------|-----------| | TOTAL | 92 | 72.2 KB | 35.0 KB | -51% | 11.8 KB | -84% | 

The "Compact" format uses abbreviated type notation and omits redundant metadata, reducing 92 tools from 72KB to under 12KB.

📦 Installation

Claude Code

  1. Move all your MCP servers in ~/.claude.json.mcpServers to ~/.config/mcpu/config.json

  2. Add this MCP Unified to your Claude CLI

claude mcp add --scope=user mcpu -- npx --package=@mcpu/cli -c mcpu-mcp 
  1. Start Claude CLI and check /conext to verify that mcpu is the ony MCP server Claude connected.

  2. Test by asking Claude to list my mcp servers

Something like this:

> list my mcp servers ⏺ mcpu - cli (MCP)(argv: ["servers"]) ⎿ disconnected: - chroma - disconnected - Type: stdio - Command: uvx chroma-mcp --client-t ype persistent --data-dir ~/.local/share/chromadb - ENV:{"ANO … +13 lines (ctrl+o to expand) ⏺ You have 6 MCP servers configured (all disconnected): | Server | Command | |------------|--------------------------------------------| | chroma | uvx chroma-mcp (persistent chromadb) | | memory | npx -y @modelcontextprotocol/server-memory | | playwright | npx playwright run-mcp-server | | chrome-dev | npx -y chrome-devtools-mcp@latest | | context7 | npx -y @upstash/context7-mcp@latest | | tasks | tasks-mcp | To connect to a server, use connect <server>. 

Key Features

  • Progressive discovery - Servers and tools revealed only when needed
  • Schema compression - Up to 90% reduction using compact format
  • Multi-instance connections - Multiple connections to same server for true parallelism
  • Batch execution - Real cross-server parallel calls
  • Exec command - JavaScript orchestration with filtering

Usage Modes

MCPU can run in two modes:

  1. MCP Server Mode (mcpu-mcp) - For MCP-native clients like Claude Desktop
  2. CLI/Daemon Mode (mcpu-daemon + mcpu-remote) - For agents with bash access like Claude Code

The CLI mode is useful when your AI agent can execute shell commands but doesn't have native MCP support.

Packages

PackageDescription
@mcpu/cliCore CLI and MCP server

Source code is in packages/mcpu-cli.

About

MCP multiplexer with progressive discovery, parallel batch calls, code execution, and up to 90% token reduction

Resources

Stars

Watchers

Forks

Packages

No packages published