MCP-Server-Transports

Übersicht

Feedback
• STDIO-Transport (lokale Server)
Feedback
• Streamable HTTP-Transport (moderner Standard für Remote-Server)
Feedback
• SSE-Transport (veraltete Remote-Option)

STDIO-Transport

Funktionsweise des STDIO-Transports

Feedback
1. Bob startet einen MCP-Server als Kindprozess
Feedback
2. Die Kommunikation erfolgt über Prozess-Streams: Bob schreibt in die STDIN des Servers, der Server antwortet über STDOUT
Feedback
3. Jede Nachricht wird durch ein Zeilenumbruchzeichen begrenzt
Feedback
4. Nachrichten sind als JSON-RPC 2.0 formatiert

Client                    Server
  |                         |
  |---- JSON-Nachricht ---->| (via STDIN)
  |                         | (verarbeitet Anfrage)
  |<---- JSON-Nachricht ----| (via STDOUT)
  |                         |

STDIO-Eigenschaften

Feedback
• Lokalisierung: Läuft auf demselben Gerät wie Bob
Feedback
• Leistung: Sehr geringe Latenz und Overhead (kein Netzwerk-Stack beteiligt)
Feedback
• Einfachheit: Direkte Prozesskommunikation ohne Netzwerkkonfiguration
Feedback
• Beziehung: Eins-zu-eins-Beziehung zwischen Client und Server
Feedback
• Sicherheit: Inhärent sicherer ohne Netzwerkexposition

Wann STDIO verwenden

Feedback
• Lokale Integrationen und Tools, die auf demselben Gerät laufen
Feedback
• Sicherheitssensible Operationen
Feedback
• Anforderungen mit geringer Latenz
Feedback
• Single-Client-Szenarien (eine Bob-Instanz pro Server)
Feedback
• Befehlszeilen-Tools und Skripte

STDIO-Implementierungsbeispiel

const server = new Server({name: 'local-server', version: '1.0.0'});
// Tools registrieren...

// STDIO-Transport verwenden
const transport = new StdioServerTransport(server);
transport.listen();

Streamable HTTP-Transport

Funktionsweise des Streamable HTTP-Transports

Feedback
1. Der Server stellt einen einzelnen HTTP-Endpunkt (MCP-Endpunkt) bereit, der sowohl POST- als auch GET-Methoden unterstützt
Feedback
2. Bob sendet Anfragen an diesen MCP-Endpunkt über HTTP POST
Feedback
3. Der Server verarbeitet die Anfrage und sendet eine Antwort zurück
Feedback
4. Optional kann der Server Server-Sent Events (SSE) über dieselbe Verbindung nutzen, um mehrere Nachrichten oder Benachrichtigungen an Bob zu streamen

Client                             Server
  |                                  |
  |---- HTTP POST /mcp_endpoint ---->| (Client-Anfrage)
  |                                  | (verarbeitet Anfrage)
  |<--- HTTP-Antwort / SSE-Stream ---| (Server-Antwort / Stream)
  |                                  |

Streamable HTTP-Eigenschaften

Feedback
• Moderner Standard: Bevorzugte Methode für neue Remote-MCP-Server-Implementierungen
Feedback
• Remote-Zugriff: Kann auf einem anderen Gerät als Bob gehostet werden
Feedback
• Skalierbarkeit: Kann mehrere Client-Verbindungen gleichzeitig verarbeiten
Feedback
• Protokoll: Funktioniert über Standard-HTTP/HTTPS
Feedback
• Flexibilität: Unterstützt einfache Anfrage-Antwort und fortgeschrittenes Streaming
Feedback
• Einzelner Endpunkt: Verwendet einen einzelnen URL-Pfad für die gesamte MCP-Kommunikation
Feedback
• Authentifizierung: Kann Standard-HTTP-Authentifizierungsmechanismen nutzen
Feedback
• Rückwärtskompatibilität: Server können die Kompatibilität mit älteren HTTP+SSE-Clients aufrechterhalten

Wann Streamable HTTP verwenden

Feedback
• Alle neuen Remote-MCP-Server-Entwicklungen
Feedback
• Server, die robuste, skalierbare und flexible Kommunikation benötigen
Feedback
• Integrationen, die möglicherweise Streaming-Daten oder Server-gesendete Benachrichtigungen beinhalten
Feedback
• Öffentliche Dienste oder zentrale Tools
Feedback
• Ersetzen veralteter SSE-Transport-Implementierungen

Streamable HTTP-Implementierungsbeispiel

{
  "mcpServers": {
    "StreamableHTTPMCPName": {
      "httpURL": "http://localhost:8080/mcp"
    }
  }
}

Rückwärtskompatibilität mit HTTP+SSE

SSE-Transport (Legacy)

Funktionsweise des SSE-Transports

Feedback
1. Bob verbindet sich über eine HTTP-GET-Anfrage mit dem SSE-Endpunkt des Servers
Feedback
2. Dies stellt eine persistente Verbindung her, über die der Server Ereignisse an Bob senden kann
Feedback
3. Für die Client-zu-Server-Kommunikation stellt Bob HTTP-POST-Anfragen an einen separaten Endpunkt
Feedback
4. Die Kommunikation erfolgt über zwei Kanäle:
   • Ereignis-Stream (GET): Server-zu-Client-Updates
   • Nachrichten-Endpunkt (POST): Client-zu-Server-Anfragen

Client                             Server
  |                                  |
  |---- HTTP GET /events ----------->| (SSE-Verbindung herstellen)
  |<---- SSE-Ereignis-Stream --------| (persistente Verbindung)
  |                                  |
  |---- HTTP POST /message --------->| (Client-Anfrage)
  |<---- SSE-Ereignis mit Antwort ---| (Server-Antwort)
  |                                  |

SSE-Eigenschaften

Feedback
• Remote-Zugriff: Kann auf einem anderen Gerät als Bob gehostet werden
Feedback
• Skalierbarkeit: Kann mehrere Client-Verbindungen gleichzeitig verarbeiten
Feedback
• Protokoll: Funktioniert über Standard-HTTP (keine speziellen Protokolle erforderlich)
Feedback
• Persistenz: Hält eine persistente Verbindung für Server-zu-Client-Nachrichten aufrecht
Feedback
• Authentifizierung: Kann Standard-HTTP-Authentifizierungsmechanismen nutzen

Wann SSE verwenden

Feedback
• Remote-Zugriff über Netzwerke
Feedback
• Multi-Client-Szenarien
Feedback
• Öffentliche Dienste
Feedback
• Zentrale Tools, auf die viele Nutzer zugreifen müssen
Feedback
• Integration mit Web-Diensten

SSE-Implementierungsbeispiel

import express from 'express';

const app = express();
const server = new Server({name: 'remote-server', version: '1.0.0'});
// Tools registrieren...

// SSE-Transport verwenden
const transport = new SSEServerTransport(server);
app.use('/mcp', transport.requestHandler());
app.listen(3000, () => {
  console.log('MCP-Server lauscht auf Port 3000');
});

Deployment-Überlegungen

STDIO: Lokales Deployment

Feedback
• Installation: Die Server-Executable muss auf jedem Nutzergerät installiert werden
Feedback
• Distribution: Du musst Installationspakete für verschiedene Betriebssysteme bereitstellen
Feedback
• Updates: Jede Instanz muss separat aktualisiert werden
Feedback
• Ressourcen: Verwendet CPU, Arbeitsspeicher und Festplatte des lokalen Geräts
Feedback
• Zugriffskontrolle: Basiert auf den Dateisystem-Berechtigungen des lokalen Geräts
Feedback
• Integration: Einfache Integration mit lokalen Systemressourcen (Dateien, Prozesse)
Feedback
• Ausführung: Startet und stoppt mit Bob (Kindprozess-Lebenszyklus)
Feedback
• Abhängigkeiten: Alle Abhängigkeiten müssen auf dem Nutzergerät installiert sein

Feedback
• Auf deinem Gerät laufen
Feedback
• Direkten Zugriff auf das lokale Dateisystem haben
Feedback
• Bei Bedarf von Bob gestartet werden
Feedback
• Keine Netzwerkkonfiguration benötigen
Feedback
• Neben Bob oder über einen Paketmanager installiert werden müssen

Remote: Gehostetes Deployment

Feedback
• Installation: Einmalig auf einem Server installiert, von vielen Nutzern aufgerufen
Feedback
• Distribution: Ein einzelnes Deployment bedient mehrere Clients
Feedback
• Updates: Zentralisierte Updates betreffen alle Nutzer sofort
Feedback
• Ressourcen: Verwendet Server-Ressourcen, nicht lokale Geräteressourcen
Feedback
• Zugriffskontrolle: Über Authentifizierungs- und Autorisierungssysteme verwaltet
Feedback
• Integration: Komplexere Integration mit nutzerspezifischen Ressourcen
Feedback
• Ausführung: Läuft als unabhängiger Dienst (oft kontinuierlich)
Feedback
• Abhängigkeiten: Auf dem Server verwaltet, nicht auf Nutzergeräten

Feedback
• Auf einem zentralen Server laufen
Feedback
• Mit serverseitigen Anmeldedaten eine Verbindung zu Datenbanken herstellen
Feedback
• Kontinuierlich für mehrere Nutzer verfügbar sein
Feedback
• Ordnungsgemäße Netzwerksicherheitskonfiguration erfordern
Feedback
• Mit Container- oder Cloud-Technologien deployed werden

Hybride Ansätze

Feedback
1. STDIO mit Netzwerkzugriff: Ein lokaler STDIO-Server, der als Proxy zu Remote-Diensten fungiert
Feedback
2. Remote mit lokalen Befehlen: Ein Remote-Server, der Operationen auf dem Client-Gerät über Callbacks auslösen kann
Feedback
3. Gateway-Muster: STDIO-Server für lokale Operationen, die mit Remote-Servern für spezialisierte Funktionen verbunden sind

Transport-Vergleich

Transports in Bob Shell konfigurieren