mcplite
shriraj26-01/mcplite
Zero-dep MCP multiplexer. Share MCP servers across terminals. 10 GB → 420 MB.
Instalação
npx convez-ai shriraj26-01/mcplite1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
mcplite 🪶
The zero-dependency MCP multiplexer. 10 GB → 450 MB.
Share MCP server processes across all your terminal sessions. No HTTP server. No config files. Just Unix sockets.
The Problem
Every AI coding assistant (Kiro, Claude Code, Cursor) spawns a full copy of each MCP server per terminal session:
5 terminals × 7 MCP servers = 35 processes → 10+ GB RAM
After a few hours, orphaned processes pile up and your machine grinds to a halt.
The Solution
mcplite runs one instance of each MCP server and shares it across all sessions:
5 terminals × 7 bridges (3 MB each) + 7 shared servers = 450 MB total
Install
git clone https://github.com/YOUR_USERNAME/mcplite.git
cd mcplite
bash install.sh
Usage
Zero manual steps. After install:
- Open any terminal → run
kiro-cli - First session: orchestrator auto-starts (~5s)
- Every subsequent session: connects instantly (~0.3s)
- Close all terminals → orchestrator stays alive
- Open kiro again → instant connect, servers still warm
Results
| Before | After | |
|---|---|---|
| Processes (5 terminals) | 35 | 6 servers + 5 tiny bridges |
| Memory | 10 GB | 420 MB |
| Startup (warm) | 3-5s | 0.2-0.4s |
| Each new terminal | +1.2 GB | +7.5 MB |
| Bridge memory | N/A | 1.5 MB each (compiled C) |
How It Works
Terminal 1 ──> mcp-bridge (C) ──> ┌──────────────┐
[17KB, 1.5MB] │ │──> mongodb (1)
│ │──> gitlab (1)
Terminal 2 ──> mcp-bridge (C) ──> │ Orchestrator │──> jira (1)
[17KB, 1.5MB] │ (18MB RAM) │──> jenkins (1)
│ │──> postgres (1)
Terminal N ──> mcp-bridge (C) ──> └──────────────┘
[17KB, 1.5MB]
- Bridge: 17KB compiled C binary. Relays stdin/stdout ↔ Unix socket. 1.5 MB RAM.
- Orchestrator: Daemon with per-server listening sockets. Routes requests via ID rewriting.
- Auto-start: Bridge auto-launches orchestrator if not running. Zero manual steps.
- Protocol: Raw MCP JSON\n on per-server sockets. No framing overhead.
Features
- Zero dependencies — Python stdlib + 17KB compiled C bridge
- Zero config — auto-starts, auto-detects, auto-reconnects
- Survives sleep/wake — bridge reconnects transparently after laptop suspend
- Init caching — subsequent terminals get instant responses
- Circuit breaker — per-server failure isolation
- Auto-restart — crashed servers restart with exponential backoff
- Memory watchdog — monitors RSS, prevents unbounded growth
- Bounded queues — 10K pending requests max with 5-min TTL
- Graceful shutdown — SIGTERM drains requests, then cleans up
- flock() PID — kernel handles crash cleanup (no stale locks)
Configuration
Edit ~/.mcp-orchestrator/config.json:
{
"servers": {
"mongodb": {
"command": "npx",
"args": ["--prefer-offline", "-y", "mongodb-mcp-server", "--connectionString", "YOUR_URI"]
},
"gitlab": {
"command": "npx",
"args": ["--prefer-offline", "-y", "@zereight/mcp-gitlab"],
"env": {"GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_TOKEN"}
}
}
}
Commands
python3 ~/.mcp-orchestrator/orchestrator.py status # Check health
python3 ~/.mcp-orchestrator/orchestrator.py stop # Stop daemon
python3 ~/.mcp-orchestrator/orchestrator.py start # Manual start
tail -f /tmp/mcp-orchestrator.log # Live logs
Reverting
cp ~/.kiro/settings/mcp.json.bak ~/.kiro/settings/mcp.json
Architecture
See ARCHITECTURE.md for the full production design including:
- Length-prefixed frame protocol
- Monotonic ID rewriting for collision prevention
- Circuit breaker state machine
- Failure modes and recovery strategies
- Memory management (bounded to <50 MB)
Comparison
| mcplite | avelino/mcp | mcp-proxy | |
|---|---|---|---|
| Dependencies | 0 | 47 | 12 |
| Setup | Auto | Config file | Config file |
| Protocol | Unix socket | HTTP/SSE | HTTP/SSE |
| Target | Local dev | Enterprise | Bridge |
| Language | Python | Rust | Python |
| Memory (daemon) | 15 MB | ~50 MB | N/A |
Requirements
- Python 3.8+
- Linux/macOS (Unix sockets)
- Any MCP-compatible CLI (Kiro, Claude Code, Cursor)
License
MIT