docs: clarify when Client(raise_exceptions=True) actually raises

未關閉

#3,287 建立於 2026年8月11日 1 則留言 0 個 reaction 已指派 0 人在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度: 3/5
預估耗時: 1-2 天
新手友好度: 72/100

Issue 類型: 文件
描述清晰度: 基本清楚
活躍度: 冷清
技術堆疊: python
領域: documentation

研究方向

從 src/mcp/client/client.py 中的 raise_exceptions TODO 開始，追蹤記憶體內用戶端和 HTTP 用戶端的目前行為，包括 async with Client(...) 中對 ExceptionGroup 的處理。將其與 docs/troubleshooting.md 中的指引進行比較，然後在 docs/client/ 和/或 docs/troubleshooting.md 中記錄已確認的語義。完成標準是使用者能夠識別受影響的失敗，並在建議的模式與在 context manager 內捕捉 MCPError 之間進行選擇。

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

描述

P3 v1 v2

Description

Client exposes raise_exceptions: bool = False with a code TODO asking when raise_exceptions=True actually raises:

https://github.com/modelcontextprotocol/python-sdk/blob/main/src/mcp/client/client.py (around the raise_exceptions field)

What's missing

There is no clear user-facing documentation of:

Which failure modes are affected (in-process server exceptions vs transport/protocol errors)
How this interacts with ExceptionGroup wrapping from async with Client(...)
Recommended patterns vs catching MCPError inside the context manager (as docs/troubleshooting.md already teaches)

Proposed work

Trace current behavior on main for in-memory and HTTP clients
Document the real semantics in docs/client/ and/or docs/troubleshooting.md
Add a small docs_src example and/or regression test if behavior is surprising
Only change runtime behavior if docs reveal a clear bug; prefer docs-first

TODO(Marcelo) on Client.raise_exceptions in src/mcp/client/client.py
#1401 ClientSession Error Handling (different surface; has an open PR)
troubleshooting ExceptionGroup guidance

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

貢獻指南

開啟貢獻指南

從這裡開始

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

modelcontextprotocol/python-sdk 的其他 Issue

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 · 4 則留言 · 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日建立
Streamable HTTP stateless servers hang clients on the listen-mode GET (_handle_get_request opens a hold-open SSE stream) 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3492 · 1 則留言 · 2026年9月11日建立

查看 modelcontextprotocol/python-sdk 的全部 Issue

相似的 Issue

[Bug] 发布机 Chrome applet 1.3 打开双语 Web 资产变英文（zh-hans 语言码不命中 zh-CN）未關閉

🐛 Bug 🔔 Pending processing

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

jumpserver/jumpserver#17584 · 2026年9月21日建立
Sphinx ScyllaDB Theme: 1 broken link 未關閉

link-check link-check:sphinx-theme

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

scylladb/scylladb-docs-homepage#274 · 2026年9月21日建立
[feature][processing] Add profile selection options to qgis_process (Request in QGIS) 未關閉

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

qgis/QGIS-Documentation#11275 · 2026年9月21日建立
fix(automation): do not restart an active subject delivery 未關閉

bug priority:normal ready-for-dev

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

OpenHands/extensions#626 · 1 則留言 · 2026年9月21日建立
Change observation tooltip text 未關閉

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

CSCfi/sd-search-api#39 · 2026年9月21日建立

更多 Python Issue