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

オープン

#3,287 2026年8月11日に作成コメント 1 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 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 にドキュメント化します。ユーザーが影響を受ける失敗を特定し、推奨されるパターンとコンテキストマネージャー内で 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日 19分
マージ済み PR（30日）: 29

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
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 · コメント 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日に作成
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

Update contributor page in the docs オープン

fix: inaccuracy ⚠️

難易度 2/5 1〜3時間初心者へのやさしさ 72/100

uabrc/uabrc.github.io#1255 · コメント 1 件 · 2026年9月21日に作成
melange/apko: attest-build-provenance always fails on fork PRs (missing id-token) オープン

難易度 2/5 1〜3時間初心者へのやさしさ 84/100

ethereum-optimism/factory#64 · 2026年9月21日に作成
Type stubs omit the `connection` keyword on module-level `read_json` and `write_csv` オープン

難易度 2/5 1〜3時間初心者へのやさしさ 90/100

duckdb/duckdb-python#627 · 2026年9月21日に作成
custom cli groups do not show up when using the --help flag オープン

難易度 2/5 1〜3時間初心者へのやさしさ 68/100

geobeyond/potto#73 · 2026年9月21日に作成
Add link for tutorial オープン

documentation

難易度 1/5 1時間未満初心者へのやさしさ 78/100

Qiskit/qiskit-addon-sqd#376 · 2026年9月21日に作成

Python の issue をもっと見る