MCP-Server-Transporte

Übersicht

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

STDIO-Transport

Wie STDIO-Transport funktioniert

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

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

STDIO-Eigenschaften

Feedback
• Lokalität: Läuft auf derselben Maschine 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 Werkzeuge, die auf derselben Maschine laufen
Feedback
• Sicherheitskritische Operationen
Feedback
• Anforderungen mit geringer Latenz
Feedback
• Einzelclient-Szenarien (eine Bob-Instanz pro Server)
Feedback
• Befehlszeilenwerkzeuge oder IDE-Erweiterungen

STDIO-Implementierungsbeispiel

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

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

Streamable HTTP-Transport

Wie Streamable HTTP-Transport funktioniert

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 mit 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 verwenden, um mehrere Nachrichten oder Benachrichtigungen an Bob zu streamen

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

Streamable HTTP-Eigenschaften

Feedback
• Moderner Standard: Bevorzugte Methode für neue Remote-MCP-Serverimplementierungen
Feedback
• Remote-Zugriff: Kann auf einer anderen Maschine 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 Request-Response und fortgeschrittenes Streaming
Feedback
• Einzelner Endpunkt: Verwendet einen einzelnen URL-Pfad für die gesamte MCP-Kommunikation
Feedback
• Authentifizierung: Kann Standard-HTTP-Authentifizierungsmechanismen verwenden
Feedback
• Rückwärtskompatibilität: Server können Kompatibilität mit älteren HTTP+SSE-Clients aufrechterhalten

Wann Streamable HTTP verwenden

Feedback
• Alle neuen Remote-MCP-Serverentwicklungen
Feedback
• Server, die robuste, skalierbare und flexible Kommunikation erfordern
Feedback
• Integrationen, die Streaming-Daten oder servergesendete Benachrichtigungen beinhalten können
Feedback
• Öffentliche Dienste oder zentralisierte Werkzeuge
Feedback
• Ersatz von Legacy-SSE-Transportimplementierungen

Protokollaushandlung

{
  "mcpServers": {
    "my-server": {
      "url": "https://ihre-server-url.com/mcp",
      "protocolNegotiation": "legacy"
    }
  }
}

Streamable HTTP-Implementierungsbeispiel

{
  "mcpServers": {
    "StreamableHTTPMCPName": {
      "type": "streamable-http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

Rückwärtskompatibilität mit HTTP+SSE

SSE-Transport (entfernt)

Migration vom SSE-Transport

Feedback
• Streamable HTTP: Stellen Sie einen einzelnen MCP-Endpunkt bereit, der HTTP-POST-Anfragen akzeptiert. Dies ist der empfohlene Weg für Remote-Server. Siehe Streamable HTTP-Transport.
Feedback
• STDIO: Wenn der Server lokal auf derselben Maschine wie Bob läuft, konvertieren Sie ihn zu einem STDIO-Server. Siehe STDIO-Transport.

Bereitstellungsüberlegungen

STDIO: Lokale Bereitstellung

Feedback
• Installation: Die ausführbare Serverdatei muss auf dem Computer jedes Benutzers installiert werden
Feedback
• Verteilung: Sie müssen Installationspakete für verschiedene Betriebssysteme bereitstellen
Feedback
• Updates: Jede Instanz muss separat aktualisiert werden
Feedback
• Ressourcen: Verwendet CPU, Speicher und Festplatte der lokalen Maschine
Feedback
• Zugriffskontrolle: Verlässt sich auf die Dateisystemberechtigungen der lokalen Maschine
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 Computer des Benutzers installiert werden

Feedback
• Auf dem Computer des Benutzers laufen
Feedback
• Direkten Zugriff auf das lokale Dateisystem haben
Feedback
• Bei Bedarf von Bob gestartet werden
Feedback
• Keine Netzwerkkonfiguration erfordern
Feedback
• Neben Bob oder über einen Paketmanager installiert werden müssen

Remote: Gehostete Bereitstellung

Feedback
• Installation: Einmal auf einem Server installiert, von vielen Benutzern aufgerufen
Feedback
• Verteilung: Einzelne Bereitstellung bedient mehrere Clients
Feedback
• Updates: Zentralisierte Updates betreffen alle Benutzer sofort
Feedback
• Ressourcen: Verwendet Serverressourcen, nicht lokale Maschinenressourcen
Feedback
• Zugriffskontrolle: Verwaltet durch Authentifizierungs- und Autorisierungssysteme
Feedback
• Integration: Komplexere Integration mit benutzerspezifischen Ressourcen
Feedback
• Ausführung: Läuft als unabhängiger Dienst (oft kontinuierlich)
Feedback
• Abhängigkeiten: Auf dem Server verwaltet, nicht auf Benutzermaschinen

Feedback
• Auf einem zentralen Server laufen
Feedback
• Sich mit Datenbanken mit serverseitigen Anmeldeinformationen verbinden
Feedback
• Für mehrere Benutzer kontinuierlich verfügbar sein
Feedback
• Ordnungsgemäße Netzwerksicherheitskonfiguration erfordern
Feedback
• Mit Container- oder Cloud-Technologien bereitgestellt werden

Hybrid-Ansätze

Feedback
1. STDIO mit Netzwerkzugriff: Ein lokaler STDIO-Server, der als Proxy für Remote-Dienste fungiert
Feedback
2. Remote mit lokalen Befehlen: Ein Remote-Server, der Operationen auf der Client-Maschine über Callbacks auslösen kann
Feedback
3. Gateway-Muster: STDIO-Server für lokale Operationen, die sich mit Remote-Servern für spezialisierte Funktionen verbinden

Transportvergleich

Transporte in Bob konfigurieren