# 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
```

3. Start Claude CLI and check `/conext` to verify that `mcpu` is the ony MCP server Claude connected.

4. 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

| Package                                              | Description             |
| ---------------------------------------------------- | ----------------------- |
| [@mcpu/cli](https://www.npmjs.com/package/@mcpu/cli) | Core CLI and MCP server |

Source code is in `packages/mcpu-cli`.