convez.ai
MCP Server
shriraj26-01

mcplite

shriraj26-01/mcplite

Ver no GitHub
InicialPluginScore · de 0 a 100

Zero-dep MCP multiplexer. Share MCP servers across terminals. 10 GB → 420 MB.

Instalação

$npx convez-ai shriraj26-01/mcplite

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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:

  1. Open any terminal → run kiro-cli
  2. First session: orchestrator auto-starts (~5s)
  3. Every subsequent session: connects instantly (~0.3s)
  4. Close all terminals → orchestrator stays alive
  5. Open kiro again → instant connect, servers still warm

Results

BeforeAfter
Processes (5 terminals)356 servers + 5 tiny bridges
Memory10 GB420 MB
Startup (warm)3-5s0.2-0.4s
Each new terminal+1.2 GB+7.5 MB
Bridge memoryN/A1.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

mcpliteavelino/mcpmcp-proxy
Dependencies04712
SetupAutoConfig fileConfig file
ProtocolUnix socketHTTP/SSEHTTP/SSE
TargetLocal devEnterpriseBridge
LanguagePythonRustPython
Memory (daemon)15 MB~50 MBN/A

Requirements

  • Python 3.8+
  • Linux/macOS (Unix sockets)
  • Any MCP-compatible CLI (Kiro, Claude Code, Cursor)

License

MIT

Ver o original no GitHub

Bom para

Relacionados