modelcontextprotocol/python-sdk

在 GitHub 檢視

The official Python SDK for Model Context Protocol servers and clients

星號: 24.3k
分支: 4k
開放的新手 issue: 50
已索引 issue: 258
平均合併: 1 天 16 小時
30 天內合併 PR: 25

主要語言: Python
授權條款: MIT
最近 GitHub push: 2026年9月16日
最近索引: 2026年9月20日
貢獻指南: 貢獻指南
行為準則: 行為準則
新手標籤: good first issue help wanted

適合新手全部

未關閉全部

[v2] modern streamable HTTP watch_disconnect can busy-loop and peg a CPU core 未關閉

v2

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

modelcontextprotocol/python-sdk#3439 · 3 則留言 · 2026年9月3日建立
TransportSecuritySettings.allowed_hosts is compared case-sensitively (NOT RFC 9110 compliant), so an uppercase host entry (the Windows default) rejects every fetch-based client with 421 未關閉

v1 v2

難度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/python-sdk#3437 · 5 則留言 · 2026年9月3日建立
In-process callback failures break tool calls and notification sends 未關閉

v2

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

modelcontextprotocol/python-sdk#3434 · 1 則留言 · 2026年9月3日建立
coerce_request_id() folds non-canonical numeric strings, conflating wire-distinct JSON-RPC ids 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3432 · 4 則留言 · 2026年9月2日建立
test_safe_join_rejects_symlink_escape fails on Windows without elevation or Developer Mode 未關閉

v2

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

modelcontextprotocol/python-sdk#3408 · 3 則留言 · 2026年8月28日建立
Tool input schemas carry a pydantic-derived title on every property 未關閉

v1 v2

難度 3/5 1-2 天新手友好度 52/100

modelcontextprotocol/python-sdk#3391 · 5 則留言 · 2026年8月25日建立
[v2] Expose request cancellation on MCPServer tool Context 未關閉

v2

難度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/python-sdk#3389 · 1 則留言 · 2026年8月25日建立
A tool returning a non-finite float puts invalid JSON in the text content block 未關閉

v1 v2

難度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/python-sdk#3385 · 1 則留言 · 2026年8月25日建立
ClientSessionGroup raises KeyError when a server exposes no tools, resources or prompts 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3384 · 2 則留言 · 2026年8月25日建立
OAuthClientProvider auth lock is permanently poisoned when httpx closes async_auth_flow from a different task (RuntimeError: The current task is not holding this lock) 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3382 · 4 則留言 · 2026年8月25日建立
pyjwt[crypto] as an unconditional dependency blocks installation on platforms without a cryptography wheel (e.g. Windows on ARM) 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3373 · 6 則留言 · 2026年8月24日建立
Client SSRF / protocol confusion: streamable HTTP transport follows server 3xx into internal+loopback services (follow_redirects=True, no host validation; #2106 closed but fix #2180 never merged) 未關閉

v1 v2

難度 4/5 3-5 天新手友好度 55/100

modelcontextprotocol/python-sdk#3358 · 6 則留言 · 2026年8月21日建立
[v2] Allow MCPServer to disable subscriptions/listen 未關閉

spec-2026-07-28 v2

難度 4/5 3-5 天新手友好度 68/100

modelcontextprotocol/python-sdk#3357 · 5 則留言 · 4 個 reaction · 2026年8月21日建立
Server.call_tool()'s input-validation error result discards jsonschema.ValidationError's structured fields, leaving only free-text prose 未關閉

v1 v2

難度 3/5 1-2 天新手友好度 55/100

modelcontextprotocol/python-sdk#3351 · 1 則留言 · 2026年8月21日建立
Client treats JSON-null structuredContent as missing, skipping outputSchema validation 未關閉

spec-2026-07-28 v2

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

modelcontextprotocol/python-sdk#3345 · 2 則留言 · 2026年8月20日建立
Prompt validation errors are logged with an unnecessary traceback 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3342 · 2 則留言 · 2026年8月20日建立
A tool returning a non-finite float fails on the client with an error naming the tool 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3341 · 2 則留言 · 2026年8月20日建立
Windows MCP SSH stdio transport closes after initialize when PROGRAMDATA is missing from inherited environment 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3335 · 1 則留言 · 2026年8月19日建立
Add add_resource_template() to MCPServer 未關閉

v2

難度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/python-sdk#3333 · 1 則留言 · 2026年8月19日建立
[v2] Expose the SSE max_event_size setting in Streamable HTTP clients 未關閉

v2

modelcontextprotocol/python-sdk#3332 · 7 則留言 · 已指派 1 人 · 2026年8月18日建立
streamable-http client: no size bound before JSONRPCMessage.model_validate_json — one large server message can OOM the client 未關閉

v1 v2

難度 4/5 3-5 天新手友好度 48/100

modelcontextprotocol/python-sdk#3330 · 2 則留言 · 2026年8月18日建立
docs: no guidance for supporting SDK 1.x and 2.x at the same time 未關閉

v2

難度 2/5 半天新手友好度 62/100

modelcontextprotocol/python-sdk#3309 · 10 則留言 · 2026年8月14日建立
Streamable HTTP clean EOF reconnects can exceed the request retry budget 未關閉

bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3307 · 5 則留言 · 2026年8月14日建立
A tool returning an empty list produces a CallToolResult with zero content blocks 未關閉

enhancement needs decision P2 v1 v2

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

modelcontextprotocol/python-sdk#3305 · 1 則留言 · 2026年8月13日建立
check_resource_allowed(): path matching skips dot-segment/percent-encoding normalization (auth-boundary bypass) 未關閉

auth bug needs confirmation P2 v1 v2

難度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/python-sdk#3303 · 4 則留言 · 2026年8月13日建立
find_context_parameter treats a Context return annotation as a parameter 未關閉

P3 v1 v2

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

modelcontextprotocol/python-sdk#3298 · 5 則留言 · 2026年8月12日建立
resource_url_from_server_url preserves explicit default ports 未關閉

P3 v1 v2

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

modelcontextprotocol/python-sdk#3297 · 1 則留言 · 2026年8月12日建立
docs: clarify when Client(raise_exceptions=True) actually raises 未關閉

P3 v1 v2

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

modelcontextprotocol/python-sdk#3287 · 1 則留言 · 2026年8月11日建立
Authentication in High Level MCPServer 未關閉

P3 question v1 v2

難度 4/5 3-5 天新手友好度 38/100

modelcontextprotocol/python-sdk#3283 · 3 則留言 · 2026年8月11日建立
streamable_http (legacy mode): early response.aclose() discards a TCP connection per JSON-RPC exchange — deterministic reproduction for #2707 未關閉

bug P2 v1 v2

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

modelcontextprotocol/python-sdk#3281 · 1 則留言 · 2026年8月11日建立
New example: examples/servers/admission-gate — a real approve/deny ServerMiddleware demo 未關閉

documentation P3 v2

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

modelcontextprotocol/python-sdk#3272 · 4 則留言 · 2026年8月8日建立
Mcp-Name accepts an orphan header, while Mcp-Param-* rejects it as a routing spoof 未關閉

improves spec compliance P3 spec-2026-07-28 v2

難度 3/5 1-2 天新手友好度 42/100

modelcontextprotocol/python-sdk#3269 · 1 則留言 · 2026年8月8日建立
`handle_get_stream` reconnects indefinitely when the server ends the GET stream normally (`attempt = 0` defeats `MAX_RECONNECTION_ATTEMPTS`) 未關閉

P2 v1 v2

難度 4/5 3-5 天新手友好度 55/100

modelcontextprotocol/python-sdk#3257 · 1 則留言 · 2026年8月5日建立
OAuth client can never recover from an expired DCR client secret — even though the SDK's own server issues and enforces one 未關閉

bug P1 v1 v2

難度 4/5 3-5 天新手友好度 68/100

modelcontextprotocol/python-sdk#3256 · 1 則留言 · 2026年8月5日建立
[v2] MCPServer reports empty experimental capabilities as {} via initialize but None via server/discover 未關閉

P2 spec-2026-07-28 v2

難度 4/5 3-5 天新手友好度 52/100

modelcontextprotocol/python-sdk#3254 · 1 則留言 · 2026年8月5日建立
OAuthClientProvider._initialize() breaks transparent refresh: missing update_token_expiry + missing oauth_metadata load 未關閉

P1 v1 v2

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

modelcontextprotocol/python-sdk#3250 · 2026年8月4日建立
OAuth token refresh hits the wrong endpoint when the auth server lives under a path 未關閉

P1 v1 v2

難度 4/5 3-5 天新手友好度 48/100

modelcontextprotocol/python-sdk#3240 · 2 則留言 · 2026年8月3日建立
Expose create_mcp_http_client and McpHttpClientFactory as public API (2.0 made them private-only) 未關閉

P1 v2

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

modelcontextprotocol/python-sdk#3238 · 4 則留言 · 2026年8月3日建立
Parameterized Context loses request state in resource and prompt handlers 未關閉

P1 v2

難度 4/5 3-5 天新手友好度 55/100

modelcontextprotocol/python-sdk#3235 · 2 則留言 · 2026年8月1日建立
Client-side support for the tasks extension (io.modelcontextprotocol/tasks, SEP-2663) 未關閉

P2 spec-2026-07-28 v2

難度 4/5 3-5 天新手友好度 52/100

modelcontextprotocol/python-sdk#3226 · 3 則留言 · 2026年7月30日建立
Bug: OAuth provider holds context.lock for the whole request, so the standalone GET SSE stream stalls the first tools/call by ~15s 未關閉

P2 v1 v2

難度 4/5 3-5 天新手友好度 25/100

modelcontextprotocol/python-sdk#3209 · 1 則留言 · 2026年7月29日建立
[v2] JSON-RPC error responses leave client OpenTelemetry spans UNSET 未關閉

bug needs confirmation P2 v2

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

modelcontextprotocol/python-sdk#3174 · 9 則留言 · 2026年7月26日建立
Fix Streamable HTTP Accept header quality-factor handling 未關閉

bug needs confirmation P3 v1 v2

難度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/python-sdk#3154 · 1 則留言 · 2026年7月23日建立
Deeply-nested-body test fails on macOS: rejected as INVALID_REQUEST (-32600) instead of PARSE_ERROR (-32700) 未關閉

bug P3 spec-2026-07-28 v2

難度 3/5 1-2 天新手友好度 58/100

modelcontextprotocol/python-sdk#3146 · 2026年7月22日建立
Add `ClientSession.register_tool_schema()` for dynamic tool discovery patterns 未關閉

enhancement needs decision P3 v1 v2

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

modelcontextprotocol/python-sdk#3145 · 3 則留言 · 2026年7月22日建立
OAuth client sends client_id in token body under client_secret_basic (strict servers reject as multiple auth methods) 未關閉

auth bug needs confirmation P1 v1 v2

難度 4/5 3-5 天新手友好度 48/100

modelcontextprotocol/python-sdk#3138 · 6 則留言 · 2026年7月21日建立
perf: JSONRPCMessage smart union scores all four branches on every inbound message 未關閉

enhancement needs decision P3 v1 v2

難度 3/5 1-2 天新手友好度 25/100

modelcontextprotocol/python-sdk#3136 · 2026年7月19日建立
Dispatcher mints a request id already used by a completed caller-supplied request (spec: ids MUST NOT be reused in a session) 未關閉

bug needs confirmation P2 v2

難度 3/5 1-2 天新手友好度 86/100

modelcontextprotocol/python-sdk#3126 · 2 則留言 · 2026年7月18日建立
RequireAuthMiddleware omits RFC 6750 scope in WWW-Authenticate on 401/403 未關閉

auth bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3103 · 2 則留言 · 4 個 reaction · 2026年7月16日建立
Streamable HTTP server never returns the spec-mandated 405 for GET requests it won't serve as SSE (406/400 instead) — breaks client SSE-probe fallback 未關閉

bug needs confirmation P2 v1 v2

難度 3/5 1-2 天新手友好度 58/100

modelcontextprotocol/python-sdk#3102 · 5 則留言 · 2026年7月16日建立

只顯示最新的 100 筆

這個頁面只列出最近收錄的部分。完整清單在進階篩選裡，可以依語言、難度和預計耗時篩選。

前往進階篩選

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