kfirtoledo/multi-mcp

A flexible and dynamic Multi-MCP Proxy Server that acts as a single MCP server while connecting to and routing between
multiple backend MCP servers over STDIO or SSE.
## 🚀 Features
✅ Supports both STDIO and SSE transports
✅ Can connect to MCP servers running in either STDIO or SSE mode
✅ Proxies requests to multiple MCP servers
✅ Automatically initializes capabilities (tools, prompts, resources) from connected servers
✅ Dynamically add/remove MCP servers at runtime (via HTTP API)
✅ Supports tools with the same name on different servers (using namespacing)
✅ Deployable on Kubernetes, exposing a single port to access all connected MCP servers through the proxy
## 📦 Installation
To get started with this project locally:
bash
# Clone the repository
git clone https://github.com/kfirtoledo/multi-mcp.git
cd multi-mcp
# Install using uv (recommended)
uv venv
uv pip install -r requirements.txt
## 🖥️ Running Locally
You can run the proxy locally in either STDIO or SSE mode depending on your needs:
### 1. STDIO Mode
For CLI-style operation (pipe-based communication).
Used for chaining locally executed tools or agents.
bash
uv run main.py --transport stdio
### 2. SSE Mode
Runs an HTTP SSE server that exposes a /sse endpoint.
Useful for remote access, browser agents, and network-based tools.
bash
uv run main.py --transport sse
Note: You can also configure the host and port using --host / --port arguments.
## ⚙️ Configuration
The proxy is initialized using a JSON config (default: ./mcp.json):
json
"mcpServers": {
"weather": {
"command": "python",
"args": ["./tools/getweather.py"]
},
"calculator": {
"command": "python",
"args": ["./tools/calculator.py"]
This config defines the initial list of MCP-compatible servers to spawn and connect at startup.
Note: Tool names are namespaced internally as servername::toolname to avoid conflicts and allow multiple servers to expose tools with the same base name. For example, if an MCP server named calculator provides an add tool, it will be referenced as calculator::add.
You can also connect to a remote MCP server using SSE:
json
"mcpServers": {
"weather": {
"url": "http://127.0.0.1:9080/sse"
More examples can be found in the examples/config/ directory.
## 🔄 Dynamic Server Management (SSE only)
When running in SSE mode, you can add/remove/list MCP servers at runtime via HTTP endpoints:
| Method | Endpoint | Description |
| GET | /mcpservers | List active MCP servers |
| POST | /mcpservers | Add a new MCP server |
| DELETE| /mcpservers/{name} | Remove an MCP server by name |
| GET | /mcptools | Lists all available tools and their serves sources|
### Example to add a new server:
bash
curl -X POST http://localhost:8080/mcpservers \
-H "Content-Type: application/json" \
--data @addserver.json
addserver.json:
json
"mcpServers": {
"unitconverter": {
"command": "python",
"args": ["./tools/unitconverter.py"]
## 🐳 Docker
You can containerize and run the SSE server in K8s: