MCP聚合器
一个MCP（模型上下文协议）聚合器，允许您将多个MCP服务器组合到一个接口中。代码主要是人工智能生成的。
为什么要将MCP服务器组合成一个？
这款应用程序的主要原因是为了克服Cursor一次只能使用2台MCP服务器的限制。无论如何，在我添加第三台MCP服务器时，它破坏了使用另外两台服务器之一的能力。
概述
MCP聚合器充当Cursor（或任何其他MCP客户端）和多个MCP服务器之间的桥梁。它既可以作为MCP服务器（与Cursor通信时），也可以作为MCP客户端（与后端MCP服务器通信时）。
主要特点：
- 为Cursor和其他MCP客户端提供stdio接口
- 连接到多个后端MCP服务器
- 为后端服务器的方法添加前缀（例如，“快捷方式”MCP中的“search_stries”方法的“shortcut_search_stries”）
- 通过用下划线替换破折号来自动清理工具名称，以实现游标兼容性
- 可通过环境变量和JSON配置文件进行配置
- 具有可配置级别的调试日志记录
安装
使用安装脚本（推荐）
您可以使用我们的安装脚本安装最新版本的combine-mcp：
# Download and run the installation script
curl -fsSL https://raw.githubusercontent.com/nazar256/combine-mcp/main/install.sh | bash
# Or install a specific version
curl -fsSL https://raw.githubusercontent.com/nazar256/combine-mcp/main/install.sh | bash -s -- -v v1.0.0脚本将：
- 检测您的操作系统和体系结构
- 下载相应的预编译二进制文件
- 验证校验和
- 将其安装到PATH中的合适位置
- 使其可执行
使用go install（替代）
# Install directly from GitHub (binary will be placed in $GOPATH/bin)
go install github.com/nazar256/combine-mcp/cmd/combine-mcp@latest
# Ensure $GOPATH/bin is in your PATH
# For example, add this to your .bashrc or .zshrc:
# export PATH=$PATH:$(go env GOPATH)/bin使用Docker（替代方案）
您可以直接使用Docker运行combined-mcp，而无需在本地安装：
# Run the latest version
docker run --rm -v ~/.config/mcp:/config ghcr.io/nazar256/combine-mcp:latest
# Run a specific version
docker run --rm -v ~/.config/mcp:/config ghcr.io/nazar256/combine-mcp:v1.0.0
# Set environment variables
docker run --rm -v ~/.config/mcp:/config -e MCP_CONFIG=/config/config.json -e MCP_LOG_LEVEL=debug ghcr.io/nazar256/combine-mcp:latest要将其与Cursor一起使用，您需要将MCP服务器配置为使用Docker：
{
"mcpServers": {
"aggregator": {
"command": "docker",
"args": ["run", "--rm", "-v", "~/.config/mcp:/config", "ghcr.io/nazar256/combine-mcp:latest"],
"env": {
"MCP_CONFIG": "/config/config.json"
}
}
}
}使用Makefile
该项目包括一个用于常见任务的Makefile：
# Build the binary
make build
# Run tests
make test
# Clean up build artifacts
make clean用法
配置聚合器
基本上，您可以将现有的Cursor MCP配置复制到您选择的位置，比如说 ~/.config/mcp/config.json。它应该看起来像这样：
对于Cursor用户来说，一个很好的功能是从MCP服务器中过滤工具。您可以在Cursor中管理工具，使其不超过40个工具的限制，并且不公开不希望Cursor使用的工具。
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": ["-y", "@shortcut/mcp"],
"env": {
"SHORTCUT_API_TOKEN": "your-shortcut-api-token-here"
},
"tools": {
"allowed": ["search-stories", "get-story", "create-story"]
}
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "your-github-token-here"
}
}
}
}在Cursor中配置聚合器
现在，在Cursor配置中，您可以只保留一个MCP服务器聚合器。配置可能看起来像这样（假设您有 combine-mcp 二进制文件已安装在您的PATH中，您有 ~/.config/mcp/config.json 文件）：
{
"mcpServers": {
"aggregator": {
"command": "combine-mcp",
"env": {
"MCP_CONFIG": "~/.config/mcp/config.json"
}
}
}
}环境变量
MCP_CONFIG：配置文件的路径（必需）MCP_LOG_LEVEL：日志记录级别（错误、信息、调试、跟踪）-默认值：infoMCP_LOG_FILE：日志文件的路径MCP_PROTOCOL_VERSION：强制使用特定的协议版本以实现兼容性MCP_CURSOR_MODE：启用光标特定的兼容性调整
用例
多个客户端的统一MCP配置
一个实际用例是维护 单MCP配置文件 它在不同的支持MCP的客户端之间共享（例如Cursor、Windsurf、Gemini CLI、Codex、Claude Code、GitHub Copilot代理等）。
您可以：
- 配置所有后端MCP服务器（及其机密） 一次 在聚合器配置中。
- 为每位客户指出 相同
combine-mcp二进制与相同MCP_CONFIG文件。 - 让聚合器为每个客户端处理工具的前缀、过滤和规范化。
这有几个好处：
- 单一真相来源 MCP服务器和工具可用于此。
- 集中秘密管理 –API令牌和其他凭据仅存在于聚合器配置中。
- 一致的行为 跨不同的IDE/代理，无需对每个客户端的MCP进行重新配置。
- 秘密隔离 无需直接与AI代理工具共享秘密。
工具名称消毒
MCP聚合器通过用下划线替换破折号来自动清理工具名称。这是必要的，因为Cursor存在一个已知问题，即它无法正确检测或使用名称中带有破折号的工具。
例如：
- 原始工具名称：
get-user - 山宁泰工具名称：
get_user - 前缀工具名称（用于快捷方式服务器）：
shortcut_get_user
净化是透明的——当您使用净化后的名称调用工具时，聚合器在将请求转发到后端服务器时将其映射回原始名称。
工具筛选
MCP聚合器支持每个服务器的可选工具过滤。当您想要：
- 将暴露的刀具数量限制在Cursor的刀具限制范围内（最多40个刀具）
- 仅公开每个服务器的特定工具
- 避免服务器之间的工具名称冲突
- 通过减少要处理的工具数量来提高性能
要启用工具筛选，请添加 tools 使用 allowed 列出要公开的工具的数组：
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": ["-y", "@shortcut/mcp"],
"env": {
"SHORTCUT_API_TOKEN": "your-shortcut-api-token-here"
},
"tools": {
"allowed": [
"search-stories",
"get-story",
"create-story",
"assign-current-user-as-owner"
]
}
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "your-github-token-here"
},
"tools": {
"allowed": [
"create-pr",
"list-prs",
"get-pr",
"merge-pr"
]
}
}
}
}