HTTP client fails connect when the server acknowledges notifications/initialized with an empty 200
Maintainer antworten meist innerhalb von 1 Tag
@koic arbeitet bereits daran.
Seit 13.10.2026.
Bewertung
- Schwierigkeit
- 1/5
- Geschätzter Aufwand
- Unter einer Stunde
- Anfängerfreundlichkeit
- 20/100
- Issue-Typ
- Bug
- Klarheit
- Klar beschrieben
- Aktivitätsstatus
- Veraltet
- Tech-Stack
- ruby
- Bereich
- backend-api-design
Rechercherichtung
Read MCP::Client::HTTP#send_request and resolve_response_body, which the issue identifies as the failing path. Check the existing tests for the notifications/initialized response and the linked pull requests #599 and #600 to see the work already underway. Done means a notification acknowledged with a bodyless 2xx no longer raises, while a request with the same response still raises unsupported_media_type.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Observed behavior
With mcp 1.7.0 (and 0.15.0), MCP::Client#connect with the legacy initialize handshake over Streamable HTTP fails against servers that acknowledge notifications/initialized with 200 OK, an empty body and no Content-Type, instead of 202 Accepted:
MCP::Client::RequestHandlerError: Unsupported Content-Type: nil. Expected application/json or text/event-stream.
error_type: :unsupported_media_type
The initialize request succeeds. The error comes from the following notifications/initialized POST: send_request passes the response to resolve_response_body, which returns early only for 202 and raises for any other response without a JSON or SSE content type.
For example, Freshservice's hosted MCP server (Freshworks, https://<account>.freshservice.com/mcp) responds this way:
POST /mcp {"jsonrpc":"2.0","method":"notifications/initialized"}
HTTP/1.1 200 OK
Content-Length: 0
I ran each SDK's client against the same Freshservice server, with the same OAuth token, on 2026-10-13:
| Client | notifications/initialized response |
Result |
|---|---|---|
TypeScript SDK 1.32.1 (StreamableHTTPClientTransport) |
200, no Content-Type |
Connects, listTools returns 40 tools |
Python SDK 2.3.0 (streamable_http_client) |
200, no Content-Type |
Connects, list_tools returns 40 tools |
Ruby SDK main (7735046) |
200, no Content-Type |
Unsupported Content-Type: nil |
Expected behavior
The spec says the server MUST return 202 Accepted with no body when it accepts a notification (Transports, Sending Messages to the Server), so the server is out of spec here. Still, a notification awaits no response, and both reference SDKs accept any 2xx for it:
- TypeScript SDK 1.32.1: after the
202check, the content type is checked only when the POST carried a request. For a notification, any other 2xx reaches the// No requests in message but got 200 OK - still need to release connectionbranch, which cancels the body and returns. - Python SDK 2.3.0: after the
202check, the content-type handling is gated onisinstance(message, JSONRPCRequest), with the comment "The server MUST NOT send a response to notifications." A notification answered with 2xx falls through without reading the body.
In both, a request answered the same way is still an error: TypeScript throws StreamableHTTPError and Python returns a JSON-RPC error, each with "Unexpected content type".
I'd expect connect to succeed when a notification is acknowledged with a 2xx and no body. Requests should keep raising unsupported_media_type for the same response.
Reproduction
require "mcp"
require "webmock"
include WebMock::API
WebMock.enable!
url = "https://example.com/mcp"
stub_request(:post, url)
.with { |req| JSON.parse(req.body)["method"] == "initialize" }
.to_return(
status: 200,
headers: { "Content-Type" => "application/json" },
body: { jsonrpc: "2.0", id: "1", result: { protocolVersion: "2025-11-25", capabilities: {}, serverInfo: { name: "s", version: "1" } } }.to_json,
)
stub_request(:post, url)
.with { |req| JSON.parse(req.body)["method"] == "notifications/initialized" }
.to_return(status: 200, body: "")
MCP::Client.new(transport: MCP::Client::HTTP.new(url: url)).connect(mode: :legacy)
# => MCP::Client::RequestHandlerError: Unsupported Content-Type: nil. ...
Fix: #599. It returns nil instead of raising in that branch when the message is a notification and the status is 2xx, matching the behaviour above.
- Vorherrschende Sprache
- Ruby
- Sterne
- 924
- Forks
- 136
- Ø Merge
- 1 T. 5 Std.
- Gemergte PRs (30 T.)
- 37
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Keine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus modelcontextprotocol/ruby-sdk
-
Empty members in the Accept header cause a 500Evtl. vergeben @koic hat das heute übernommen. Offenbug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
modelcontextprotocol/ruby-sdk#609 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Error responses carry "id": null, which the MCP schema does not allowEvtl. vergeben @koic hat das heute übernommen. Offenbug
Schwierigkeit 3/5 Ein halber Tag Anfängerfreundlichkeit 45/100
modelcontextprotocol/ruby-sdk#606 ·
Maintainer antworten meist innerhalb von 1 Tag
-
String request ids are limited to letters, digits, "_" and "-"Evtl. vergeben @koic hat das heute übernommen. Offenbug
modelcontextprotocol/ruby-sdk#603 · 1 zugewiesene Person ·
Maintainer antworten meist innerhalb von 1 Tag
-
Methods of undeclared capabilities return -32603 instead of -32601Evtl. vergeben @koic hat das heute übernommen. Offenbug
modelcontextprotocol/ruby-sdk#602 · 1 zugewiesene Person ·
Maintainer antworten meist innerhalb von 1 Tag
-
Requests with "id": null are run like notificationsEvtl. vergeben @koic hat das heute übernommen. Offenbug
modelcontextprotocol/ruby-sdk#601 · 1 zugewiesene Person ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in modelcontextprotocol/ruby-sdk
Ähnliche Issues
-
agent:triaged bug bughunt pm:bundler priority:p1
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 70/100
SocketDev/socket-patch#1573 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug chat verified
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
Maintainer antworten meist innerhalb von 6 Tagen
-
🐞 bug pending triage
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
CircuitVerse/CircuitVerse#8031 · 2 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
BazaRb::Fake#enter rejects dotted badges accepted by BazaRb#enterEvtl. vergeben Ein verknüpfter Pull Request ist offen oder bereits gemergt. Offen
Schwierigkeit 1/5 1-3 Stunden Anfängerfreundlichkeit 84/100
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 70/100
riscv/riscv-unified-db#2740 ·
Maintainer antworten meist innerhalb von 1 Tag