Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

StreamableHTTPClientTransport should handle 404 and 406 gracefully for GET SSE stream

Offen Anfängerfreundlich
  • Stimmt etwas nicht?
#1,635 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

@nanookclaw arbeitet bereits daran.

Seit 27.4.2026.

  • #1637 von @Aboudjem — ohne Merge geschlossen
  • #1799 von @4444J99 — ohne Merge geschlossen
  • #1969 von @nanookclaw — offen

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
76/100
Issue-Typ
Bug
Klarheit
Klar beschrieben
Aktivitätsstatus
Ruhig
Tech-Stack
typescript
Bereich
api, networking

Rechercherichtung

Beginne in packages/client/src/client/streamableHttp.ts, genauer in StreamableHTTPClientTransport._startOrAuthSse(), und verfolge, wie der GET-Antwortstatus während der Initialisierung behandelt wird. Überprüfe das Verhalten mit einem POST-only MCP-Server oder, falls verfügbar, einem gezielten Client-Test. Als erledigt gilt die Aufgabe, wenn 404 und 406 wie 405 die auf POST basierende Kommunikation ohne einen fatalen Fehler fortsetzen lassen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

bug fix proposed P2 ready for work

Problem

The StreamableHTTPClientTransport._startOrAuthSse() method sends a GET request to open an SSE stream during initialization. Per the MCP spec, the server MAY respond with 405 Method Not Allowed if it doesn't support SSE streams, and the client correctly handles this.

However, many MCP servers return 404 Not Found or 406 Not Acceptable instead of 405 for this GET request:

  • 404: Server doesn't have a GET handler for the MCP endpoint (only POST)
  • 406: Server rejects Accept: text/event-stream header (e.g., requires both application/json and text/event-stream)

Both cases mean the same thing: the server does not offer an SSE stream at the GET endpoint. But the client treats them as fatal errors, preventing the connection even though POST-based communication would work fine.

Current Behavior

// packages/client/src/client/streamableHttp.ts, _startOrAuthSse()
if (response.status === 405) {
    return;  // Only 405 is handled gracefully
}
throw new SdkError(...);  // 404 and 406 throw, killing the connection

This causes errors like:

StreamableHTTPError: Streamable HTTP error: Failed to open SSE stream: Not Found

Affected Clients

This impacts any client consuming the SDK, including:

  • Gemini CLI (google-gemini/gemini-cli) — #5268, #2787
  • MCP Inspector — #1150
  • LibreChat and other MCP consumers

Proposed Fix

Treat 404 and 406 the same as 405 — all indicate the server does not offer an SSE stream at the GET endpoint:

// 404: Server has no GET handler (only POST)
// 405: Server explicitly doesn't allow GET
// 406: Server rejects the Accept header for GET
if (response.status === 404 || response.status === 405 || response.status === 406) {
    return;
}

The client will then proceed with POST-based communication, which works correctly for these servers.

Reproduction

  1. Set up an MCP server that only supports POST (no GET SSE stream)
  2. Connect using StreamableHTTPClientTransport
  3. The GET request returns 404 → client throws and disconnects
  4. POST would have worked fine

Environment

  • @modelcontextprotocol/sdk: latest
  • Discovered while debugging Gemini CLI v0.32.1 connecting to a remote HTTP MCP server (ArmorCode)
Vorherrschende Sprache
TypeScript
Sterne
13.7k
Forks
2.3k
Ø Merge
1 T. 6 Std.
Gemergte PRs (30 T.)
53

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus modelcontextprotocol/typescript-sdk

Alle Issues in modelcontextprotocol/typescript-sdk

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.