MCP Routing Gateway

Das MCP Routing Gateway ist ein zustandsloser Router und Pure Proxy, der entwickelt wurde, um das Problem zu lösen, dass "LLMs vom Benutzer unbeabsichtigte Tools auswählen", ein häufiges Problem bei aktuellen Mainstream-KI-Agenten (z. B. Claude Desktop, Cline).

🌟 Warum MCP Routing Gateway?

Wenn mehrere MCP-Server direkt bei einem Standard-KI-Agenten registriert sind, kann das LLM alle Tools frei durchsuchen und ausführen, was das Risiko birgt, unerwartete destruktive Vorgänge oder unnötige Tool-Aufrufe auszulösen.

Dieses Projekt fungiert als Vermittler zwischen dem KI-Agenten und der tatsächlichen Gruppe von MCP-Servern und bietet eine Steuerungsebene, die "dem LLM nur sicher kuratierte (gefilterte und virtualisierte) Tools präsentiert."

🏗️ Architektur

Dieses Projekt integriert intern sowohl "MCP Server"- als auch "MCP Client"-Funktionalitäten.

AI Agent (MCP Client) → | [MCP Server] Gateway [MCP Client] | → Backend MCP Servers

Frontend (MCP Server): Fungiert als "einzelner, sicherer MCP-Server" gegenüber dem KI-Agenten und akzeptiert Verbindungen über Standard-Ein-/Ausgabe (stdio).
Backend (MCP Client): Liest mcp_config.json und startet sowie verwaltet automatisch mehrere darin definierte MCP-Server (über stdio-gestartete Prozesse).

🎯 Design-Philosophie

Dieses Projekt basiert auf der strikten Philosophie, ein "Router und Pure Proxy" zu sein.

Keine Payload-Interferenz (Pass-through): Es greift nicht in Payloads wie Request-IDs oder Argumente ein. Es konzentriert sich vollständig auf die Weiterleitung der Kommunikation und fungiert als reine Pipe.
Fassaden-Muster (Filterung und Tool-Überschreibungen): Das Gateway greift nur in das Routing von tools/list (Präsentation der Tool-Liste) und tools/call (Tool-Aufruf) ein. Basierend auf der Konfigurationsdatei verbirgt es gefährliche Tools oder ersetzt sie durch sichere virtuelle Tools.

⚙️ Konfiguration

Alle Konfigurationen werden vollständig im JSON-Format verwaltet. Standardmäßig sucht das Gateway in dem Arbeitsverzeichnis ~/.mcp-gateway nach diesen Dateien. Sie können dieses Verzeichnis mit der CLI-Option --work-dir ändern.

mcp_config.json (Backend-Definition): Das Standard-Konfigurationsdateiformat für MCP-Clients. Es definiert die Gruppe von MCP-Servern, mit denen sich das Gateway verbindet und die es im Hintergrund startet.
gateway_config.json (Routing- und Filter-Definition): Eine für das Gateway einzigartige Regelkonfigurationsdatei. Sie definiert, "welche Tools verborgen werden sollen (Blockierte Tools)" und "welche Tools virtualisiert werden sollen (Virtuelle Tools)."

Für detaillierte Informationen zur Verwendung und zu den CLI-Optionen lesen Sie bitte das Benutzerhandbuch.