HTTP transport swallows non-2xx status codes causing client to hang

未關閉

#2,110 建立於 2026年2月19日 7 則留言 2 個 reaction 已指派 0 人在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度: 4/5
預估耗時: 3-5 天
新手友好度: 48/100

Issue 類型: 缺陷
描述清晰度: 基本清楚
活躍度: 冷清
技術堆疊: python
領域: api, backend

研究方向

先追蹤 src/mcp/client/streamable_http.py 中的錯誤處理，尤其是 post_writer，以及 src/mcp/client/sse.py 中的錯誤處理，尤其是 sse_reader。檢視相關 issue #1742，了解具型別錯誤的設計。當非 2xx 回應以例外形式傳遞給呼叫端、保留其 HTTP 狀態、區分 401/403，且不再讓呼叫端無限期等待時，即表示完成。

由索引模型根據 Issue 內容生成。

描述

bug P1 v2

Summary

When an MCP server returns non-2xx HTTP status codes (401/403/404/5xx), the Streamable HTTP and SSE transports do not reliably propagate the error to the caller. In the Streamable HTTP transport, post_writer catches exceptions and logs them, but the caller blocks indefinitely waiting for a response on the read stream. HTTP 404 responses are also converted to JSONRPCError(code=32600), losing the original HTTP status information.

Expected Behavior

Non-2xx HTTP responses should be surfaced as exceptions to the caller, not silently logged
The original HTTP status code should be preserved and accessible
Auth-related errors (401/403) should be distinguishable from other failures

Current Behavior

post_writer in Streamable HTTP transport catches and logs errors without forwarding them through the read stream
Callers hang indefinitely waiting for a response
HTTP 404 is converted to JSONRPCError(code=32600), destroying HTTP-level context

Affected Code

src/mcp/client/streamable_http.py (post_writer)
src/mcp/client/sse.py (sse_reader)

Related

#1742 — broader typed error classes design

主要語言: Python
星號: 24.3k
分支: 4k
平均合併: 1 天 11 小時
30 天內合併 PR: 30

貢獻指南

開啟貢獻指南

從這裡開始

先讀完整個 Issue，再讀專案的貢獻指南。
在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
Fork 儲存庫，在一個分支上完成修改。
送出 Pull Request，並在描述裡引用這個 Issue 編號。

modelcontextprotocol/python-sdk 的其他 Issue

OAuth client scope handling breaks on comma-separated scope strings 未關閉

難度 2/5 1-3 小時新手友好度 75/100

modelcontextprotocol/python-sdk#3566 · 2026年9月23日建立
Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 85/100

modelcontextprotocol/python-sdk#3546 · 5 則留言 · 2026年9月19日建立
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 76/100

modelcontextprotocol/python-sdk#3545 · 1 則留言 · 2026年9月18日建立
Revocation requires client_secret to be present 未關閉

v1 v2

難度 1/5 1 小時以內新手友好度 91/100

modelcontextprotocol/python-sdk#3508 · 2 則留言 · 2026年9月15日建立
Does same-origin redirect enforcement break MCP servers behind a reverse proxy? 未關閉

難度 2/5 1-3 小時新手友好度 64/100

modelcontextprotocol/python-sdk#3504 · 2026年9月15日建立

查看 modelcontextprotocol/python-sdk 的全部 Issue

相似的 Issue

PATCH /interviews/{id} 的 goal 字段没有任何长度上限，500KB 字符串直接落库且每次 GET detail 都全量带回未關閉

bug

難度 2/5 1-3 小時新手友好度 75/100

xinnan-tech/xiaozhi-fde-talk#263 · 2026年9月24日建立
rules: REQ-0480 'left fold' jargon is redundant with its own plain restatement 未關閉

rules

難度 1/5 1 小時以內新手友好度 90/100

elong0527/yamaa#978 · 2026年9月24日建立
Validation discards output from runners that report on stderr (jest, unittest) 未關閉

難度 2/5 1-3 小時新手友好度 70/100

huggingface/Repo2RLEnv#163 · 1 則留言 · 2026年9月24日建立
Source link in quantize_embeddings have shifted code highlights 未關閉

難度 1/5 1 小時以內新手友好度 95/100

huggingface/sentence-transformers#4074 · 2026年9月24日建立
Queue insertion button ("插入排队消息") missing in api_server sessions — canInsert allowlist only covers cli/global_agent 未關閉

comp/dashboard invalid P3

難度 2/5 1-3 小時新手友好度 70/100

NousResearch/hermes-agent#121143 · 2026年9月24日建立

更多 Python Issue

精選適合新手參與的 GitHub issue 摘要。