MCP Aggregator
About
An MCP (Model Context Protocol) aggregator that allows you to combine multiple MCP servers into a single endpoint allowing to filter specific tools.
Details
- Author
- nazar256
- GitHub stars
- 32
- Downloads
- 263
- Categories
- Developer Tools, Community, Other
Jump to
- Combines multiple MCP servers into one stdio interface.
- Prefixes tool names from backend servers (e.g., shortcut_search_stories).
- Automatically sanitizes tool names by replacing dashes with underscores.
- Supports optional per-server tool filtering (e.g., to stay under Cursor’s 40-tool limit).
- Configurable via environment variables and a JSON config file.
- Debug logging with configurable levels (error, info, debug, trace).
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP AggregatorCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via the install script, go install, Docker, or the Makefile. Create a configuration file (JSON) that lists all backend MCP servers, then configure your MCP client to point to the aggregator binary (or Docker container) with the required environment variable MCP_CONFIG set to the config file path. Environment variables like MCP_LOG_LEVEL control debugging.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp aggregator": {
"mcp": {
"command": "combine-mcp",
"env": {
"MCP_CONFIG": "~/.config/MCP/config.json",
"MCP_LOG_LEVEL": "debug",
"MCP_LOG_FILE": "~/.config/MCP/mcp.log"
}
}
}
}
}McpServers
{
"mcp": {
"command": "combine-mcp",
"env": {
"MCP_CONFIG": "~/.config/MCP/config.json",
"MCP_LOG_LEVEL": "debug",
"MCP_LOG_FILE": "~/.config/MCP/mcp.log"
}
}
}MCP Aggregator
An MCP (Model Context Protocol) aggregator that allows you to combine multiple MCP servers into a single interface. The code is mostly AI-generated.
Why combine MCP servers into one?
The primary reason for this app was to work around Cursor's limitation of only being able to use 2 MCP servers at a time. No matter which, in my case when I added 3rd MCP server, it was breaking the ability to use one of other two.
Overview
The MCP Aggregator acts as a bridge between Cursor (or any other MCP client) and multiple MCP servers. It functions both as an MCP server (when talking to Cursor) and as an MCP client (when talking to backend MCP servers).
Key features:
- Provides a stdio interface for Cursor and other MCP clients
- Connects to multiple backend MCP servers
- Prefixes methods from backend servers (e.g., "shortcut_search_stories" for "search_stories" method from a "shortcut" MCP)
- Automatically sanitizes tool names by replacing dashes with underscores for Cursor compatibility
- Configurable via environment variables and JSON config file
- Debug logging with configurable levels
Installation
Using install script (recommended)
You can install the latest version of combine-mcp using our installation script:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
