Skip to main content
Glama
Sign In
MCP Multi-Server Gateway

MCP Multi-Server Gateway

by moaaz01
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

๐ŸŒ MCP Multi-Server Gateway

Aggregate, route, and orchestrate multiple MCP backend servers behind a single MCP endpoint. Connect one gateway to Claude Desktop/Cursor and access all your MCP servers โ€” weather, database, file system, and more.

License: MIT Python 3.10+

โœจ Why a Gateway?

Instead of configuring each MCP server individually in your client:

// โŒ Without Gateway: 3 entries in claude_desktop_config.json
{
  "weather": { "command": "...", "args": ["weather_server.py"] },
  "sqlite": { "command": "...", "args": ["sqlite_server.py", "--db-path", "..."] },
  "filesystem": { "command": "...", "args": ["filesystem_server.py", "--sandbox", "..."] }
}

// โœ… With Gateway: 1 entry โ€” register/unregister servers at runtime
{
  "gateway": { "command": "python", "args": ["gateway.py"] }
}

Related MCP server: mcpware

โœจ Features

  • ๐Ÿ”ง 5 Tools: register_server, remove_server, list_servers, call_backend, route_pipeline

  • โฑ๏ธ Async Routing: Concurrent tool execution across backends via asyncio

  • ๐Ÿ“‹ Pipeline Support: Pre-configured multi-step workflows (weather-analysis, database-report)

  • ๐Ÿ“ Auto-Registration: Load backend config from JSON file on startup

  • ๐Ÿ”Œ Runtime Dynamic: Register/unregister servers without restarting

  • โฒ๏ธ Timeout Handling: 10-second per-backend timeout prevents hangs

  • ๐Ÿ–ฅ๏ธ Dual Transport: stdio and Streamable HTTP

๐Ÿš€ Quick Start

# 1. Setup
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 2. Start the gateway
python gateway.py

# 3. Register backend servers (from MCP client)
register_server(name="weather", command="python", args="weather_server.py", description="Weather alerts")
register_server(name="sqlite", command="python", args="sqlite_server.py --db-path /tmp/sample.db", description="Database queries")

With auto-registration:

python gateway.py --auto-register gateway-config.json

๐Ÿ› ๏ธ Tools Reference

register_server(name, command, args, description) -> str

Register a new backend MCP server at runtime.

remove_server(name) -> str

Remove a registered server.

list_servers() -> str

List all registered backends with status and tool counts.

call_backend(server, tool, params) -> str

Execute a tool on a specific backend. params is a JSON string.

route_pipeline(scenario) -> str

Execute a pre-configured multi-step pipeline:

  • "weather-analysis" โ€” alerts + forecast

  • "database-report" โ€” schema inspection + query

  • "custom" โ€” compose your own workflow

๐Ÿ”Œ Connecting to Clients

Claude Desktop

{
  "mcpServers": {
    "gateway": {
      "command": "python",
      "args": ["/ABSOLUTE/PATH/mcp-multi-server-gateway/gateway.py"]
    }
  }
}

Streamable HTTP Mode

python gateway.py --transport streamable-http --port 8003

๐Ÿ“ Project Structure

mcp-multi-server-gateway/
โ”œโ”€โ”€ gateway.py              # Main gateway server (FastMCP + asyncio)
โ”œโ”€โ”€ gateway-config.json     # Example auto-registration config
โ”œโ”€โ”€ requirements.txt
โ”œโ”€โ”€ setup.sh
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ .gitignore

๐Ÿ—๏ธ Architecture

         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
         โ”‚       MCP Client (Claude, etc)       โ”‚
         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                        โ”‚  single MCP connection
         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
         โ”‚     MCP Multi-Server Gateway         โ”‚
         โ”‚     (gateway.py on :8003)            โ”‚
         โ”‚                                      โ”‚
         โ”‚  register / call_backend / pipeline  โ”‚
         โ””โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
            โ”‚          โ”‚          โ”‚
     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
     โ”‚ Weather  โ”‚ โ”‚  SQLite  โ”‚ โ”‚ FileSystemโ”‚
     โ”‚ Server   โ”‚ โ”‚  Server  โ”‚ โ”‚  Server   โ”‚
     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ’ก Use Cases

Scenario

Tools Involved

Example

DevOps Debugging

sqlite.query + filesystem.read_file

"Check DB schema, then read config file"

Data Analysis

sqlite.list_tables + sqlite.query

"What tables exist? Give me top 10 customers"

Multi-weather check

weather.get_alerts ร— 2

"Alerts for CA and TX simultaneously"

Automated report

All servers in sequence

"Get weather data โ†’ query DB โ†’ write report"

๐Ÿ“œ License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers