mcpField
M
McpMux — Configure MCP servers once, connect every AI client

McpMux — Configure MCP servers once, connect every AI client

远程服务
github.com/mcpmux开发工具252 周前更新
代码仓库

关于 McpMux — Configure MCP servers once, connect every AI client

McpMux 是一款桌面应用,用于统一管理多个 AI 客户端的 MCP 服务配置。它在本地运行 MCP 网关,客户端只需连接一个地址即可使用所有已配置的服务。基于 Rust 与 Tauri 2 构建,支持 Windows、macOS 和 Linux。

主要功能

  1. 01本地 MCP 网关,单一地址接入
  2. 02一次配置,所有客户端共享
  3. 03按工作区(Space)隔离服务与凭据
  4. 04按文件夹路由到不同工具集
  5. 05功能集控制可用的工具、提示词与资源
  6. 06凭据存储于操作系统钥匙串

适用场景

  1. 01在 Cursor、Claude Desktop、VS Code 等客户端间统一管理 MCP 服务
  2. 02按工作和个人等场景隔离服务与凭据
  3. 03为不同代码仓库分配不同的工具集

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址http://localhost:45818/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

McpMux

License: GPL v3 GitHub release CI Windows macOS Linux

一款应用,管理你在所有 AI 客户端中使用的全部 MCP 服务。

官方网站 · 下载 · 发现服务 · 功能 · Discord


问题所在

Cursor、Claude Desktop、VS Code、Windsurf 都支持 MCP,但每个客户端都需要单独的配置文件。它们彼此无法互通。

┌─────────────────────────────────────────────────────────────────────────┐
│  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     │
└─────────────────────────────────────────────────────────────────────────┘

添加一个服务?编辑四个文件。 轮换一个 API 密钥?编辑四个文件。 换一台新机器?从头开始。

而那些 API 密钥呢?它们存放在纯文本 JSON 文件中,机器上的任何人都能读取。

解决方案

McpMux 是一款运行本地 MCP 网关的桌面应用。只需配置一次服务,所有 AI 客户端都通过同一个 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  │
└─────────────────────────────────────────────────────────────────────────┘

在 McpMux 中添加服务后,所有已连接的客户端都会立即获取该服务,无需重启或手动刷新。移除工具或更新提示词?所有客户端都会立即知晓。

McpMux 轻量且跨平台,采用 Rust 和 Tauri 2 构建,在 Windows、macOS 和 Linux 上安静地运行于系统托盘中,同时仅占用极少的 CPU 和内存。

McpMux 仪表板


工作原理

1. 从内置目录安装服务,或添加自己的服务

2. 将一份配置粘贴到每个 AI 客户端中(这是你最后一次需要配置):

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

3. 搞定。所有服务中的所有工具,都会立即在每个客户端中可用。

McpMux 会将调用路由到正确的服务,自动刷新 OAuth 令牌,并将凭据加密保存在操作系统的钥匙串中——之后你再也无需操心。它也会让自身保持最新:默认情况下,新版本会在启动时下载并安装(可在设置中切换),因此只需重启即可完成更新。


功能

所有服务,尽在一处

不必再在 Cursor、Claude、VS Code 和 Windsurf 中重复配置服务。在 McpMux 中安装服务后,它会立即在所有客户端中可用。展开任意服务即可查看其工具、提示词和资源。实时查看连接状态。OAuth 令牌会在后台自动刷新。

服务管理 — Azure、AWS、Notion、Docker、Slack 均已连接

100 多个服务,一键安装

不必再到处寻找 MCP 服务的代码仓库,也无需手写传输配置。浏览精心整理的 100 多个服务目录,其中包括 GitHub、Slack、PostgreSQL、Docker、Notion、AWS、Azure 等。点击安装,输入凭据,即可在你使用的所有 AI 客户端中启用服务。你也可以在 mcpmux.com 浏览完整目录。

发现服务 — 浏览 100 多个服务并一键安装

完整目录也可在 mcpmux.com 在线浏览,支持搜索、分类,以及通过深层链接一键安装。

mcpmux.com — 在线服务目录

让工作空间彼此隔离

创建彼此隔离的空间——每个空间都有自己的服务、凭据和权限。创建一个用于公司数据库和内部 API 的“工作”空间,再创建一个用于个人项目的“个人”空间。在侧边栏中单击一次即可切换,所有已连接的 AI 客户端都会自动跟随切换。不再担心在工作项目中意外查询个人数据库。

工作空间 — 在侧边栏中即时切换上下文

为不同文件夹配置不同工具

AI 客户端会告诉 McpMux 它正在使用哪个文件夹(即其 MCP 根目录)。McpMux 会据此将每个工作空间路由到各自的工具集——打开后端代码库,AI 就能看到数据库和部署工具;打开文档文件夹,它就只能看到搜索和文件系统工具。在 Workspaces 标签页中映射一次文件夹(也可以让 AI 来设置——见下文),以后每次从该路径启动会话时,都会自动匹配。匹配按文件夹进行且必须完全一致,因此项目之间不会相互泄露信息。

工作空间 — 将文件夹映射到应使用的空间和 FeatureSet

控制每个客户端可以执行的操作

并非所有 AI 客户端都应拥有相同的权限。创建功能集——精心挑选的工具、提示词和资源组合,精确控制对外开放的内容。为谨慎的工作流创建一个“只读”集合,为“React 开发”创建一个仅包含 GitHub 和 Filesystem 的集合,或者创建一个包含所有内容的“全栈开发”集合——然后通过工作空间映射将文件夹路由到相应集合。FeatureSet 中包含的功能就是会话最终匹配到的有效工具集。

功能集 — 按服务器精确选择每个集合要开放的工具

查看和管理所有已连接的客户端

实时查看连接到网关的每个 AI 应用及其状态,包括 Cursor、VS Code、Windsurf 和 Claude Code。路由由工作空间驱动:每个应用的工具集取决于其报告的文件夹对应的工作空间绑定,而不是针对每个应用单独配置。打开任意应用即可重命名、查看其路由方式或撤销其连接。新应用通过 OAuth 进行身份验证,并采用一键批准流程。

已连接的应用 — 路由由所报告的文件夹对应的工作空间驱动

让 AI 自行整理工具集

给助手一百个工具会消耗令牌,还会让它选错工具。McpMux 内置了工具优化功能,让 AI 可以直接通过聊天精简自己的工具集,无需配置文件。

以 @mux 开始请求,助手即可:

  • 发现可用内容 — mcpmux_list_spaces、mcpmux_list_all_tools、mcpmux_search_tools
  • 组合一个仅包含所需工具的精简 FeatureSet — mcpmux_manage_feature_set
  • 固定当前文件夹到该集合,让设置保持不变 — mcpmux_bind_current_workspace

工具优化 — AI 驱动的内置自我管理工具;读取操作无需确认,写入操作则需审批

读取操作无需确认;任何会更改设置的操作都会弹出一个一键批准对话框,其中会标明确切的空间——AI 提议,由你决定。@mux 触发词可将这些请求与实际工作明确区分开来,并且每项操作都可以按 ID 指定目标空间。

审批 — 每次自我管理写入操作都需先审批,并显示目标空间和具体工具变更

“@mux 为这个 Next.js 代码库创建一套精简的工具集,并将其固定到此文件夹。”


安全

MCP 默认使用包含原始 API 密钥的纯文本配置文件。McpMux 通过纵深防御取而代之:

  • OS Keychain — 将机密信息存储在平台原生的安全存储中(Windows 上为 DPAPI,macOS 上为 Keychain,Linux 上为 libsecret),绝不存放在纯文本文件中
  • AES-256-GCM — 对所有敏感数据进行字段级数据库加密
  • OAuth 2.1 + PKCE — 标准身份验证流程,支持自动刷新令牌
  • 仅限本地的网关 — 绑定到 127.0.0.1,不向网络公开任何内容
  • 每个客户端使用独立访问密钥 — 每个 AI 客户端单独进行身份验证,并拥有细粒度权限
  • 经过净化的日志 — 令牌和机密信息绝不会出现在日志输出中
  • 内存清零 — 使用后通过 zeroize 清除内存中的机密信息

所有 MCP 流量都留在你的设备上。云同步(可选,即将推出)仅同步配置元数据,绝不包含凭据或负载。


开始使用

1. 下载 McpMux — Windows、macOS、Linux

2. 添加服务 — 使用 Discover 标签页浏览 100 多个服务,或在 mcpmux.com 上探索服务,一键安装

3. 粘贴配置 — 将 Dashboard 中的代码片段复制到你的 AI 客户端中

从此以后,你再也不用编辑配置文件了。

Linux 快速安装: curl -fsSL https://install.mcpmux.com | bash

通过 Homebrew 安装 macOS 版本: brew install --cask mcpmux/tap/mcpmux

查看 mcpmux.com/download,了解所有平台和安装方式。


在 Linux 上安装

快速安装(自动检测你的发行版):

curl -fsSL https://install.mcpmux.com | bash
其他安装方式

Debian / Ubuntu(APT 软件源,支持自动更新):

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

Fedora / RHEL(从 GitHub Releases 安装):

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

Arch Linux(AUR):

yay -S mcpmux-bin

AppImage(适用于任何发行版):

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

也可以直接从 GitHub Releases 下载。


开发

pnpm setup    # First-time: install dependencies
pnpm dev      # Start development
pnpm build    # Production build
pnpm test     # Run all tests

前置要求: Rust 1.75+、Node.js 18+、pnpm 9+。Linux 还需要 gnome-keyring libsecret-1-dev librsvg2-dev pkg-config。

基于 Tauri 2(Rust + React 19)构建,使用 Axum 作为网关、ring 进行加密,使用 rmcp 支持 MCP。

项目结构
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

链接

参与贡献

请参阅 CONTRIBUTING.md 了解相关指南。

许可证

GNU 通用公共许可证 v3.0

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。