使用说明
McpMux
一个应用程序来管理每个AI客户端上的所有MCP服务器。
问题
Cursor、Claude Desktop、VS Code、Windsurf——它们都支持 主控程序,但每个都需要自己的配置文件。他们谁也不说话。
┌─────────────────────────────────────────────────────────────────────────┐
│ 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中添加一个服务器,每个连接的客户端都会立即启动它——无需重新启动,也无需手动刷新。删除工具还是更新提示?每个客户都立刻知道。
轻量级和跨平台-内置于Rust和Tauri 2中,McpMux使用最少的CPU和内存,同时在Windows、macOS和Linux上的系统托盘中安静运行。
运作原理
1. 从内置注册表安装服务器,或添加自己的服务器
2. 将一个配置粘贴到每个AI客户端中(您需要的最后一个配置):
{
"mcpServers": {
"mcpmux": {
"type": "http",
"url": "http://localhost:45818/mcp"
}
}
}
3. 完成。现在,每个服务器上的每个工具都可以在每个客户端上使用。
McpMux将调用路由到正确的服务器,自动刷新OAuth令牌,并在操作系统密钥链中对凭据进行加密——你永远不会再想它了。它也保持 自身 当前:默认情况下,新版本在启动时下载并安装(在“设置”中切换),因此只需重新启动即可。
特征
所有服务器,一个地方
无需在Cursor、Claude、VS Code和Windsurf之间重复服务器配置。在McpMux中安装服务器,即可立即在任何地方使用。展开任何服务器以检查其工具、提示和资源。查看实时连接状态。OAuth令牌在后台自动刷新。
100+台服务器,一键
停止搜索MCP服务器存储库和手写传输配置。浏览100多台服务器的精选注册表——GitHub、Slack、PostgreSQL、Docker、Notion、AWS、Azure等等。点击安装,输入您的凭据,服务器就会在您使用的每个AI客户端上运行。您还可以在以下网址浏览完整注册表 mcpmux.com 网站.
完整的注册表也可以在网上找到 mcpmux.com 网站 --通过深度链接进行搜索、分类和一键安装。
将事物分开的工作区
创建独立的空间——每个空间都有自己的服务器、凭据和权限。公司数据库和内部API的“工作”空间。一个用于副项目的“个人”空间。从侧边栏点击一下,每个连接的AI客户端都会自动跟随。不再从工作项目中意外查询您的个人数据库。
不同文件夹的不同工具
你的人工智能客户端告诉McpMux它在哪个文件夹中工作(它的MCP 根).McpMux使用它来 将每个工作区路由到自己的工具集 --打开你的后端仓库,人工智能就会看到你的数据库和部署工具;打开一个文档文件夹,它只看到搜索和文件系统。在中映射一次文件夹 工作区 选项卡(或让AI来做——见下文),来自该确切路径的每个未来会话都会自动解析。匹配是针对每个文件夹的,并且是精确的,因此不会在项目之间泄露任何信息。
控制每个客户可以做什么
并非每个AI客户端都应该具有相同的功能。创建功能集——精心策划的捆绑包,精确控制公开哪些工具、提示和资源。为谨慎的工作流程构建一个“只读”集,一个仅包含GitHub和文件系统的“反应开发”集,或者一个包含所有内容的“全栈开发”集——然后通过工作区映射将文件夹路由到它。FeatureSet包含的功能 是 会话解析的有效工具集。
查看和管理每个连接的客户端
Cursor、VS Code、Windsurf、Claude Code——实时查看连接到网关的每个AI应用程序的实时状态。路由是 工作空间驱动:每个应用程序的工具集由它报告的文件夹的工作区绑定决定,而不是为每个应用程序配置。打开任何应用程序进行重命名,查看其路由方式,或撤销其连接。新应用程序通过OAuth进行身份验证,具有一键式审批流。
让你的人工智能管理自己的工具集
给助手一百个工具,它会燃烧代币,并伸手去拿错误的工具。McpMux内置了 刀具优化 使AI能够保持 自身 lean——直接来自聊天,没有配置文件。
以以下方式开始请求 @mux 并且助手可以:
- 发现 有什么可用的--
mcpmux_list_spaces,mcpmux_list_all_tools,mcpmux_search_tools - 编排 一个专注的功能集,只包含它需要的工具--
mcpmux_manage_feature_set - 针 将当前文件夹添加到该集合中,使其保持不变--
mcpmux_bind_current_workspace
阅读是无声的;任何改变你设置的东西都会弹出 命名确切空间的单击式审批对话框 --AI提议,由你决定。这 @mux 触发器使这些请求与您的实际工作干净地分开,每个操作都可以按id针对特定的Space。
“@mux为这个Next.js仓库构建一个最小的工具集,并将其固定到这个文件夹中。”
安全
MCP默认为带有原始API密钥的纯文本配置文件。McpMux用深度防御取代了这一点:
- OS钥匙扣 --平台原生安全存储中的秘密(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.添加服务器 --使用“发现”选项卡浏览100多台服务器,或 探索mcpmux.com上的服务器 一键安装
3.粘贴配置 --将代码片段从仪表板复制到您的AI客户端
这是你最后一次接触配置文件。
Linux快速安装:
curl -fsSL https://install.mcpmux.com | bashmacOS通过Homebrew:
brew install --cask mcpmux/tap/mcpmux看 mcpmux.com/下载 适用于所有平台和安装方法。
在Linux上安装
快速安装 (自动检测您的发行版):
curl -fsSL https://install.mcpmux.com | bash
Other install methods
Debian/Ubuntu (APT存储库用于自动更新):
curl -fsSL https://install.mcpmux.com/apt | sudo bash
Fedora/RHEL (来自GitHub发布):
# 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
应用程序图像 (任何发行版):
curl -fsSL https://install.mcpmux.com | bash # auto-detects, falls back to AppImage
或直接从以下网址下载 GitHub 发布.
发展
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.
内置于 金牛座2 (Rust+React 19), 阿克苏姆 对于网关, 戒指 对于加密, rmcp 对于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
链接
- 网站和服务器发现 — mcpmux.com 网站
- 下载 — mcpmux.com/下载
- 特征 — mcpmux.com/features
- 服务器定义报告 — github/mcpmux/mcp服务器
- 社区聊天 — 不和
贡献
看 贡献.md 作为指导方针。
