McpMux

io.github.mcpmuxPublished by GitHub account mcpmuxv0.1.1Updated Oct 24, 2026

McpMux — configure MCP servers once, connect every AI client through one local gateway.

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

A desktop app that runs a local MCP gateway, letting one assistant client reach every configured MCP server through a single local URL.

What you can do
Route all MCP servers through one local gateway URL that each AI client connects to once, instead of separate config files per client. Install servers from a built-in registry and inspect their tools, prompts and resources with live connection status. Separate servers, credentials and permissions into isolated Spaces, and route toolsets per project folder. Restrict what each client sees with Feature Sets of selected tools, prompts and resources. Let the assistant discover, search and compose its own toolset and pin it to the current folder, with approval prompts for changes. View and revoke connected clients.
When to use it
Useful when several AI clients (such as Cursor, Claude Desktop, VS Code or Windsurf) each need the same MCP servers and you want one place to configure them, keep credentials out of plain-text config files, and limit which tools each project or client can reach.
Requirements
A desktop install on Windows, macOS or Linux; it runs as a local process and is desktop-only. Each AI client needs the gateway config snippet pointing at the local HTTP endpoint. Building from source needs Rust 1.75+, Node.js 18+ and pnpm 9+; Linux also needs keyring and libsecret packages.
Before you install
It stores credentials for the servers you add, in the OS keychain and an encrypted local database, and routes their calls; review which servers and Spaces a client can reach. Changes proposed by the assistant to your setup require approval, but reads are silent. The gateway binds to localhost only. Updates install automatically on launch by default and can be toggled in Settings.

Installation

In SourceWeft

  1. Open McpMux in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

McpMux

[License: GPL v3] [GitHub release] [CI] [Windows] [macOS] [Linux]

One app to manage all your MCP servers across every AI client.

Website · Download · Discover Servers · Features · Discord

The Problem

Cursor, Claude Desktop, VS Code, Windsurf — they all support MCP, but each one needs its own config file. None of them talk to each other.

┌─────────────────────────────────────────────────────────────────────────┐│  Today: every client manages MCP servers independently                  ││                                                                         ││  Cursor       → config.json    → github, slack, db  + API keys         ││  Claude       → config.json    → github, slack, db  + API keys  (dupe) ││  VS Code      → settings.json  → github, slack, db  + API keys  (dupe) ││  Windsurf     → config.json    → github, slack, db  + API keys  (dupe) ││                                                                         ││  ⚠ 4 config files  ·  4 copies of every API key  ·  all plain text     │└─────────────────────────────────────────────────────────────────────────┘

Add a server? Edit four files. Rotate an API key? Edit four files. New machine? Start from scratch.

And those API keys? Sitting in plain-text JSON files anyone on your machine can read.

The Fix

McpMux is a desktop app that runs a local MCP gateway. You configure servers once — every AI client connects through a single URL.

┌─────────────────────────────────────────────────────────────────────────┐│  With McpMux: one gateway, every client                                 ││                                                                         ││  Cursor       ─┐                                                        ││  Claude       ─┤                  ┌──→  GitHub                          ││  VS Code      ─┼──→  McpMux      ├──→  Slack                           ││  Windsurf     ─┤   localhost:45818├──→  PostgreSQL                      ││  Any client   ─┘                  └──→  + all your servers              ││                                                                         ││  ✓ 1 config  ·  credentials encrypted in OS keychain  ·  instant sync  │└─────────────────────────────────────────────────────────────────────────┘

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.

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.

[McpMux Dashboard]

How It Works

1. Install servers from the built-in registry — or add your own

2. Paste one config into each AI client (the last config you'll ever need):

json
{  "mcpServers": {    "mcpmux": {      "type": "http",      "url": "http://localhost:45818/mcp"    }  }}

3. Done. Every tool from every server is available in every client, right now.

McpMux routes calls to the right server, refreshes OAuth tokens automatically, and keeps credentials encrypted in your OS keychain — you never think about it again. It also keeps itself current: new versions download and install on launch by default (toggle in Settings), so a restart is all it takes.

Features

All Your Servers, One Place

No more duplicating server configs across Cursor, Claude, VS Code, and Windsurf. Install a server in McpMux and it's immediately available everywhere. Expand any server to inspect its tools, prompts, and resources. See live connection status. OAuth tokens refresh automatically in the background.

[Server Management — Azure, AWS, Notion, Docker, Slack all connected]

100+ Servers, One Click

Stop hunting for MCP server repos and hand-writing transport configs. Browse a curated registry of 100+ servers — GitHub, Slack, PostgreSQL, Docker, Notion, AWS, Azure, and more. Click install, enter your credentials, and the server is live across every AI client you use. You can also browse the full registry at mcpmux.com.

[Discover — browse 100+ servers and install with one click]

The full registry is also available on the web at mcpmux.com — with search, categories, and one-click install via deep links.

[mcpmux.com — server registry on the web]

Workspaces That Keep Things Separate

Create isolated Spaces — each with their own servers, credentials, and permissions. A "Work" space for company databases and internal APIs. A "Personal" space for side projects. Switch in one click from the sidebar and every connected AI client follows automatically. No more accidentally querying your personal database from a work project.

[Workspaces — switch context instantly from the sidebar]

Different Tools for Different Folders

Your AI client tells McpMux which folder it's working in (its MCP root). McpMux uses that to route each workspace to its own toolset — open your backend repo and the AI sees your database and deploy tools; open a docs folder and it sees only search and filesystem. Map a folder once in the Workspaces tab (or let the AI do it — see below) and every future session from that exact path resolves automatically. Matching is per-folder and exact, so nothing leaks across projects.

[Workspaces — map a folder to the Space and FeatureSet it should get]

Control What Each Client Can Do

Not every AI client should have the same power. Create Feature Sets — curated bundles that control exactly which tools, prompts, and resources are exposed. Build a "Read Only" set for cautious workflows, a "React Development" set with just GitHub and Filesystem, or a "Full Stack Dev" set with everything — then route a folder to it via a Workspace mapping. A FeatureSet's included features are the effective toolset a session resolves to.

[Feature Sets — pick exactly which tools each bundle exposes, per server]

See and Manage Every Connected Client

Cursor, VS Code, Windsurf, Claude Code — see every AI app connected to your gateway in real time, with live status. Routing is workspace-driven: each app's toolset is decided by the Workspace binding for the folder it reports, not configured per app. Open any app to rename it, see how it's routed, or revoke its connection. New apps authenticate via OAuth with a one-click approval flow.

[Connected apps — routing is workspace-driven per reported folder]

Let Your AI Curate Its Own Toolset

Hand an assistant a hundred tools and it burns tokens and reaches for the wrong one. McpMux ships a built-in Tool Optimization capability so the AI can keep itself lean — straight from chat, no config files.

Start a request with @mux and the assistant can:

  • Discover what's available — mcpmux_list_spaces, mcpmux_list_all_tools, mcpmux_search_tools
  • Compose a focused FeatureSet of just the tools it needs — mcpmux_manage_feature_set
  • Pin the current folder to that set so it sticks — mcpmux_bind_current_workspace

[Tool Optimization — the built-in self-management tools the AI drives, reads silent and writes gated]

Reads are silent; anything that changes your setup pops a one-click approval dialog that names the exact Space — the AI proposes, you decide. The @mux trigger keeps these requests cleanly separated from your real work, and every operation can target a specific Space by id.

[Approval — every self-management write asks first, showing the target Space and the exact tool diff]

"@mux build a minimal toolset for this Next.js repo and pin it to this folder."

Security

MCP defaults to plain-text config files with raw API keys. McpMux replaces that with defense in depth:

  • OS Keychain — secrets in platform-native secure storage (DPAPI on Windows, Keychain on macOS, libsecret on Linux), never in plain-text files
  • AES-256-GCM — field-level database encryption for all sensitive data
  • OAuth 2.1 + PKCE — standard auth flow with automatic token refresh
  • Local-only gateway — binds to 127.0.0.1, nothing exposed to the network
  • Per-client access keys — each AI client authenticates independently with granular permissions
  • Sanitized logs — tokens and secrets never appear in log output
  • Memory zeroization — secrets wiped from memory after use via zeroize

All MCP traffic stays on your machine. Cloud sync (optional, coming soon) only covers config metadata — never credentials or payloads.

Getting Started

1. Download McpMux — Windows, macOS, Linux

2. Add servers — use the Discover tab to browse 100+ servers, or explore servers on mcpmux.com and install with one click

3. Paste the config — copy the snippet from the Dashboard into your AI clients

That's the last config file you'll ever touch.

Linux quick install: curl -fsSL https://install.mcpmux.com | bash

macOS via Homebrew: brew install --cask mcpmux/tap/mcpmux

See mcpmux.com/download for all platforms and install methods.

Install on Linux

Quick install (detects your distro automatically):

bash
curl -fsSL https://install.mcpmux.com | bash
Other install methods

Debian / Ubuntu (APT repository for automatic updates):

bash
curl -fsSL https://install.mcpmux.com/apt | sudo bash

Fedora / RHEL (from GitHub Releases):

bash
# Download the latest .rpmsudo dnf install https://github.com/mcpmux/mcp-mux/releases/latest/download/mcpmux-0.0.12-1.amd64.rpm

Arch Linux (AUR):

bash
yay -S mcpmux-bin

AppImage (any distro):

bash
curl -fsSL https://install.mcpmux.com | bash  # auto-detects, falls back to AppImage

Or download directly from GitHub Releases.

Development

bash
pnpm setup    # First-time: install dependenciespnpm dev      # Start developmentpnpm build    # Production buildpnpm test     # Run all tests

Prerequisites: Rust 1.75+, Node.js 18+, pnpm 9+. Linux also needs gnome-keyring libsecret-1-dev librsvg2-dev pkg-config.

Built with Tauri 2 (Rust + React 19), Axum for the gateway, ring for encryption, rmcp for MCP.

Project structure 
mcp-mux/├── apps/desktop/          # Tauri desktop app (React + Rust)├── crates/│   ├── mcpmux-core/       # Domain logic│   ├── mcpmux-gateway/    # HTTP gateway, OAuth, routing│   ├── mcpmux-storage/    # SQLite + encryption + OS keychain│   └── mcpmux-mcp/        # MCP protocol├── packages/ui/           # Shared UI components└── tests/                 # Unit, integration, E2E tests

Links

Contributing

See CONTRIBUTING.md for guidelines.

License

GNU General Public License v3.0

Source: README.md at commit 87df4a2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts