modelcontextprotocol/python-sdk

在 GitHub 檢視

The official Python SDK for Model Context Protocol servers and clients

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

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

適合新手全部

未關閉全部

目前已索引 241 個未關閉的 Issue

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日建立
Generated output schema uses Pydantic's validation shape while structured output uses its serialization shape 未關閉

bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3100 · 2 則留言 · 2026年7月16日建立
Field alias is published in the tool schema but forwarded as an invalid Python keyword 未關閉

bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3099 · 7 則留言 · 2026年7月16日建立
Heavy sync init work (e.g. local ML models) starves stdio initialize/tool calls even with threadpool offload -- Windows GIL contention 未關閉

documentation enhancement needs decision P3 v1 v2

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

modelcontextprotocol/python-sdk#3089 · 3 則留言 · 2026年7月12日建立
FastMCP tool argument models silently ignore unknown/misspelled arguments (extra=ignore default) 未關閉

enhancement needs decision P2 v1 v2

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

modelcontextprotocol/python-sdk#3067 · 1 則留言 · 1 個 reaction · 2026年7月6日建立
[v2] RFC 9728 PRM URLs and resource matching drop query components 未關閉

auth bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3065 · 2 則留言 · 2026年7月6日建立
streamable HTTP (stateful): concurrent requests with duplicate JSON-RPC ids cross-wire responses — one request receives another's payload, the other hangs 未關閉

bug P2 v1 v2

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

modelcontextprotocol/python-sdk#3060 · 5 則留言 · 1 個 reaction · 2026年7月3日建立
FuncMetadata.pre_parse_json mis-detects str | None as non-string and corrupts JSON-looking string arguments 未關閉

bug P2 v1 v2

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

modelcontextprotocol/python-sdk#3055 · 2 則留言 · 2026年7月2日建立
WWW-Authenticate parsing matches a field name as a substring of another auth-param 未關閉

auth bug P2 v2

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

modelcontextprotocol/python-sdk#3009 · 2 則留言 · 2026年6月27日建立
[Bug] check_capability does not validate elicitation sub-capabilities (form/url) 未關閉

bug needs confirmation P2 v2

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

modelcontextprotocol/python-sdk#2965 · 2 則留言 · 2026年6月25日建立
StreamableHTTP server accumulates CLOSE_WAIT sockets behind reverse proxy due to missing disconnect cleanup 未關閉

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2958 · 1 則留言 · 2026年6月24日建立
dict[str, T] tool return types lose Annotated/Field metadata in output schema 未關閉

bug P3 v2

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

modelcontextprotocol/python-sdk#2935 · 2 則留言 · 2026年6月20日建立
Capabilities API + server/discover handler 未關閉

enhancement P2 spec-2026-07-28 v2

modelcontextprotocol/python-sdk#2896 · 已指派 1 人 · 2026年6月17日建立
Invalid JSON-RPC envelope errors are not correlated with the original request id 未關閉

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2848 · 1 則留言 · 2026年6月12日建立
Bug: anyio.Lock in async_auth_flow causes RuntimeError under concurrent OAuth MCP connections 未關閉

auth bug needs confirmation P1

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

modelcontextprotocol/python-sdk#2847 · 5 則留言 · 2026年6月12日建立
`simple-auth` is not working as expected 未關閉

auth bug P2

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

modelcontextprotocol/python-sdk#2826 · 2026年6月10日建立
Implement SEP-2663: Tasks Extension 未關閉

enhancement

難度 5/5 一週以上新手友好度 35/100

modelcontextprotocol/python-sdk#2806 · 9 則留言 · 7 個 reaction · 2026年6月6日建立
OAuth handler doesn't support redirect URLs with params 未關閉

auth bug P2

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

modelcontextprotocol/python-sdk#2776 · 2 則留言 · 2026年6月3日建立

modelcontextprotocol/python-sdk

把新 issue 寄到你的電子郵件信箱