Router

by adamwattis

81 stars

242 downloads

Not rated

GitHub

About

Aggregates multiple MCP resource servers into a unified proxy, enabling centralized access, request routing, and response aggregation.

Details

Author: adamwattis
Repository: adamwattis/mcp-proxy-server
GitHub stars: 81
Downloads: 242
License: MIT License
Categories: Developer Tools, API, Automation, Design, AI, Infrastructure, Other

- Discover and connect to multiple MCP resource servers.
- Aggregate resources from all connected servers.
- Expose tools from all servers with automatic routing.
- Aggregate prompts from all connected servers.
- Support both stdio and SSE backend transports.
- Maintain consistent URI schemes across servers.

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 Router

Command (node, npx, python, etc.) /path/to/mcp-proxy-server/build/index.js
Environment
- MCP_CONFIG_PATH /absolute/path/to/your/config.json
- KEEP_SERVER_OPEN 1
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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

JSON

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

From the repository

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-proxy": {
      "command": "/path/to/mcp-proxy-server/build/index.js",
      "env": {
        "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
        "KEEP_SERVER_OPEN": "1"
      }
    }
  }
}

- KEEP_SERVER_OPEN will keep the SSE running even if a client disconnects. Useful when multiple clients connects to the MCP proxy.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "router": {
            "env": {
                "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
                "KEEP_SERVER_OPEN": "1"
            },
            "args": [],
            "command": "/path/to/mcp-proxy-server/build/index.js"
        }
    }
}

Linux

{
    "env": {
        "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
        "KEEP_SERVER_OPEN": "1"
    },
    "args": [],
    "command": "/path/to/mcp-proxy-server/build/index.js"
}

Macos

{
    "env": {
        "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
        "KEEP_SERVER_OPEN": "1"
    },
    "args": [],
    "command": "/path/to/mcp-proxy-server/build/index.js"
}

Windows

{
    "env": {
        "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
        "KEEP_SERVER_OPEN": "1"
    },
    "args": [],
    "command": "/path/to/mcp-proxy-server/build/index.js"
}

Aggregates multiple MCP resource servers into a single interface.

An MCP proxy server that aggregates and serves multiple MCP resource servers through a single interface. This server acts as a central hub that can:

- Connect to and manage multiple MCP resource servers
- Expose their combined capabilities through a unified interface
- Handle routing of requests to appropriate backend servers
- Aggregate responses from multiple sources

- Discover and connect to multiple MCP resource servers
- Aggregate resources from all connected servers
- Maintain consistent URI schemes across servers
- Handle resource routing and resolution

- Expose tools from all connected servers
- Route tool calls to appropriate backend servers
- Maintain tool state and handle responses

- Aggregate prompts from all connected servers
- Route prompt requests to appropriate backends
- Handle multi-server prompt responses

The server requires a JSON configuration file that specifies the MCP servers to connect to. Copy the example config and modify it for your needs:

{ "servers": [ { "name": "Server 1", "transport": { "command": "/path/to/server1/build/index.js" } }, { "name": "Server 2", "transport": { "command": "server2-command", "args": ["--option1", "value1"], "env": ["SECRET_API_KEY"] } }, { "name": "Example Server 3", "transport": { "type": "sse", "url": "http://localhost:8080/sse" } } ] }

The config file must be provided when running the server:

MCP_CONFIG_PATH=./config.json mcp-proxy-server

# Stdio npm run dev # SSE npm run dev:sse

To use with Claude Desktop, add the server config:

On MacOS:~/Library/Application Support/Claude/claude_desktop_config.jsonOn Windows:%APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "mcp-proxy": { "command": "/path/to/mcp-proxy-server/build/index.js", "env": { "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json", "KEEP_SERVER_OPEN": "1" } } } }

- KEEP_SERVER_OPENwill keep the SSE running even if a client disconnects. Useful when multiple clients connects to the MCP proxy.

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using theMCP Inspector, which is available as a package script:

The Inspector will provide a URL to access debugging tools in your browser.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

The MCP server for Bitrix24 provides AI assistants with structured access to the Bitrix24 API. It delivers up-to-date method descriptions, parameters, and valid values, allowing assistants to work with precise data instead of guesswork. This reduces code errors and accelerates Bitrix24 integration development.

One remote MCP server for 500+ production APIs — Stripe, HubSpot, Postgres, Gmail, and more. OAuth and API key auth, credential management, and a CLI.

Single tool to control all 100+ API integrations, and UI components

Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.

Self-hosted MCP gateway: convert REST/SOAP/GraphQL/SQL APIs into MCP tools with 29 pre-built adapters, OAuth2, RBAC and audit log.

A universal bridge to convert any web API into an MCP server, supporting multiple transport types.

Dynamically creates MCP servers from web API configurations, integrating any REST API, GraphQL endpoint, or web service into MCP-compatible tools.

Hosted MCP server and coordination layer for AI coding agents — live API contracts, database schema, frontend/backend mismatch detection, and shared handoff tickets for Claude Code, Cursor, Codex, and Lovable.

An MCP server that dynamically loads tools from an external JSON file configured via an environment variable.

A lightweight server exposing Axone's capabilities through the Model-Context Protocol.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Router

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sentry

Github

Fetch