Skip to content

Commit deabfec

Browse files
committed
docs: improve README first impression with problem/fix diagrams
Lead with the value proposition instead of a screenshot. Add boxed ASCII diagrams showing "The Problem" (4 duplicate configs, plain-text keys) and "The Fix" (single gateway architecture). Move dashboard screenshot after the diagrams so visitors understand what they're looking at. Mention instant client sync and lightweight Rust footprint. Signed-off-by: its-mash <mash@mcpmux.com> Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
1 parent 12e5bed commit deabfec

1 file changed

Lines changed: 31 additions & 16 deletions

File tree

README.md

Lines changed: 31 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -7,41 +7,56 @@
77
![macOS](https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=white)
88
![Linux](https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black)
99

10-
### Configure your MCP servers once. Connect every AI client.
10+
### One app to manage all your MCP servers across every AI client.
1111

1212
**[Website](https://mcpmux.com)** · **[Download](https://mcpmux.com/download)** · **[Discover Servers](https://mcpmux.com)** · **[Features](https://mcpmux.com/features)**
1313

14-
![McpMux Dashboard](docs/screenshots/space-switcher.png)
15-
1614
---
1715

1816
## The Problem
1917

20-
You use Cursor, Claude Code, VS Code, and Windsurf. They all support MCP. But every client has its own config file — and none of them talk to each other.
18+
Cursor, Claude Desktop, VS Code, Windsurf — they all support [MCP](https://modelcontextprotocol.io/), but each one needs its own config file. None of them talk to each other.
2119

2220
```
23-
Cursor → config.json → github, slack, db + API keys
24-
Claude Code → config.json → github, slack, db + API keys (copy-paste)
25-
VS Code → settings.json → github, slack, db + API keys (copy-paste)
26-
Windsurf → config.json → github, slack, db + API keys (copy-paste)
21+
┌─────────────────────────────────────────────────────────────────────────┐
22+
│ Today: every client manages MCP servers independently │
23+
│ │
24+
│ Cursor → config.json → github, slack, db + API keys │
25+
│ Claude → config.json → github, slack, db + API keys (dupe) │
26+
│ VS Code → settings.json → github, slack, db + API keys (dupe) │
27+
│ Windsurf → config.json → github, slack, db + API keys (dupe) │
28+
│ │
29+
│ ⚠ 4 config files · 4 copies of every API key · all plain text │
30+
└─────────────────────────────────────────────────────────────────────────┘
2731
```
2832

29-
Add a server? **Edit four files.** Rotate an API key? **Edit four files.** New teammate, new machine, new project? **Start from scratch.**
33+
Add a server? **Edit four files.** Rotate an API key? **Edit four files.** New machine? **Start from scratch.**
3034

31-
And those API keys? Sitting in **plain-text JSON files** anyone can read.
35+
And those API keys? Sitting in **plain-text JSON files** anyone on your machine can read.
3236

3337
## The Fix
3438

35-
McpMux is a desktop app that runs a local MCP gateway. You configure servers once — every AI client connects to the same URL.
39+
McpMux is a desktop app that runs a local MCP gateway. You configure servers once — every AI client connects through a single URL.
3640

3741
```
38-
Cursor ─┐
39-
Claude Code ─┤──→ McpMux (localhost:45818) ──→ all your MCP servers
40-
VS Code ─┤ encrypted credentials
41-
Windsurf ─┘ one config, one place
42+
┌─────────────────────────────────────────────────────────────────────────┐
43+
│ With McpMux: one gateway, every client │
44+
│ │
45+
│ Cursor ─┐ │
46+
│ Claude ─┤ ┌──→ GitHub │
47+
│ VS Code ─┼──→ McpMux ├──→ Slack │
48+
│ Windsurf ─┤ localhost:45818├──→ PostgreSQL │
49+
│ Any client ─┘ └──→ + all your servers │
50+
│ │
51+
│ ✓ 1 config · credentials encrypted in OS keychain · instant sync │
52+
└─────────────────────────────────────────────────────────────────────────┘
4253
```
4354

44-
Add a server in McpMux and it appears in Cursor, Claude, VS Code, and Windsurf instantly. No files to edit. No credentials to copy.
55+
Add a server in McpMux and every connected client picks it up instantly — no restart, no manual refresh. Remove a tool or update a prompt? Every client knows immediately.
56+
57+
Lightweight and cross-platform — built in Rust with Tauri 2, McpMux uses minimal CPU and memory while running quietly in your system tray on Windows, macOS, and Linux.
58+
59+
![McpMux Dashboard](docs/screenshots/space-switcher.png)
4560

4661
---
4762

0 commit comments

Comments
 (0)