Combine MCP

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：日志记录级别（错误、信息、调试、跟踪）-默认值：info
• MCP_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"
        ]
      }
    }
  }
}