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

Deep JSON-RPC request over stdio logs a validation error and leaves the original request pending 未關閉

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2751 · 1 則留言 · 2026年6月1日建立
Stateful Streamable HTTP: in-session exceptions are masked as an empty -32603; real cause only in a separate "Session crashed" log 未關閉

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2741 · 2 則留言 · 2026年5月31日建立
streamable_http client does not send `Origin` header → rejected with 403 by spec-compliant servers (e.g. go-sdk `CrossOriginProtection`) 未關閉

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2727 · 3 則留言 · 2026年5月30日建立
FastMCP: streamable_http_app() silently breaks when BaseHTTPMiddleware is added 未關閉

bug needs repro P3 potentially close

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

modelcontextprotocol/python-sdk#2702 · 5 則留言 · 2026年5月27日建立
`ClientSessionGroup` attempts to use capabilities that were not advertised 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2689 · 3 則留言 · 2026年5月26日建立
`OAuthClientInformationFull.redirect_uris`: pydantic strict-type-equality breaks `AnyUrl(x) != AnyHttpUrl(x)` round-trip 未關閉

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2687 · 3 則留言 · 2026年5月26日建立
FastMCP/stdio: in-flight tool responses dropped on stdin EOF when input is bash-redirected from a file 未關閉

bug P2 ready for work

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

modelcontextprotocol/python-sdk#2678 · 8 則留言 · 2026年5月25日建立
ClientSession receive loop swallows callback exceptions, replying "Invalid request parameters" to the server instead of propagating to the call_tool awaiter 未關閉

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2673 · 4 則留言 · 2026年5月24日建立
FastMCP.run(transport="stdio") produces noisy traceback on KeyboardInterrupt instead of clean exit 未關閉

bug fix proposed P3 ready for work

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

modelcontextprotocol/python-sdk#2663 · 3 則留言 · 2026年5月22日建立
Streamable HTTP server silently drops in-flight request when client reuses a JSON-RPC id 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2655 · 3 則留言 · 2026年5月21日建立
mcp.server.fastmcp.FastMCP HTTP transport deadlocks after ~5 sequential client sessions on Windows (companion to PrefectHQ/fastmcp#4192) 未關閉

bug needs repro

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

modelcontextprotocol/python-sdk#2653 · 3 則留言 · 2026年5月21日建立
DCR registration accepts redirect_uris with non-HTTPS / non-loopback / fragmented schemes 未關閉

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2629 · 1 則留言 · 2026年5月18日建立
Add option to skip output validation for mcp client 未關閉

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2626 · 3 則留言 · 2026年5月17日建立
RequestResponder.__exit__ leaks CancelledError on cancelled request, killing the stdio receive loop 未關閉

bug needs confirmation P2 potentially close

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

modelcontextprotocol/python-sdk#2610 · 3 則留言 · 2026年5月15日建立
Duplicate `initialize` with changed parameters can overwrite `ServerSession.client_params` 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2605 · 4 則留言 · 2026年5月15日建立
`ClientConfig` has inconsistent naming: `message_handler` should be `message_callback` 未關閉

enhancement needs decision P3 v2

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

modelcontextprotocol/python-sdk#2588 · 2026年5月13日建立
Expose `schema_generator` on `FastMCP` for tool params schema generation 未關閉

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2582 · 2026年5月13日建立
OAuth token refresh sends RFC 8707 resource parameter that Entra ID v2.0 rejects (AADSTS9010010) 未關閉

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2578 · 6 則留言 · 2026年5月12日建立
raise without from discards exception chain in 12 remaining sites 未關閉

bug P3

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

modelcontextprotocol/python-sdk#2564 · 3 則留言 · 2026年5月8日建立
Add `list_all_*` helpers to drain pagination 未關閉

enhancement P3 v2

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

modelcontextprotocol/python-sdk#2556 · 3 則留言 · 2026年5月8日建立
Split the core from the server and client implementations 未關閉

enhancement needs decision P3 v2

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

modelcontextprotocol/python-sdk#2486 · 4 則留言 · 2026年4月21日建立
Return 405 on GET when stateless_http=True 未關閉

bug P2

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

modelcontextprotocol/python-sdk#2474 · 4 則留言 · 2 個 reaction · 2026年4月19日建立
MCPServer unconditionally declares `prompts`, `resources`, `tools` capabilities on `initialize` 未關閉

bug P2

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

modelcontextprotocol/python-sdk#2473 · 2026年4月19日建立
stdio_client crashes on malformed UTF-8 from child stdout instead of surfacing parse error 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2454 · 3 則留言 · 2026年4月16日建立
Windows: TextIOWrapper in stdio_server() emits CRLF instead of LF, corrupting newline-delimited JSON messages 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2433 · 9 則留言 · 2026年4月13日建立
Initialize call hangs forever if MCP server does not return a `Content-Type: text/plain` 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2432 · 3 則留言 · 2026年4月13日建立
McpError is not pickle-safe and fails to unpickle 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2431 · 9 則留言 · 2026年4月13日建立
[v1.x] Server-side outputSchema validation blocks tool error reporting (isError: true) 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2429 · 2 則留言 · 2026年4月13日建立
Specific ToolNotFoundError for easier handling than ToolError in multi-tenant environments 未關閉

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2422 · 4 則留言 · 2026年4月10日建立
Bug: AssertionError: Request already responded to — cancellation race in v1.27.0 未關閉

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2416 · 14 則留言 · 2026年4月9日建立
StreamableHTTP client: _handle_reconnection resets attempt counter to 0, causing infinite retry loop 未關閉

bug P2

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

modelcontextprotocol/python-sdk#2393 · 2 則留言 · 2026年4月5日建立
Inline $ref in tool inputSchema for LLM consumption (parity with typescript-sdk) 未關閉

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2384 · 2 則留言 · 2026年4月2日建立
ClientSession: add public API for updating callbacks after initialization 未關閉

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2379 · 4 則留言 · 2026年3月30日建立
Image/ImageContent serialization fails in stateless HTTP mode 未關閉

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2376 · 3 則留言 · 5 個 reaction · 2026年3月29日建立
Design: future of `dependencies` parameter on MCPServer 未關閉

enhancement needs decision P2 v2

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

modelcontextprotocol/python-sdk#2354 · 2 則留言 · 4 個 reaction · 2026年3月26日建立
Add remove_prompt() and remove_resource() for parity with remove_tool() 未關閉

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2331 · 4 則留言 · 2026年3月22日建立
Improve log clarity for "Terminating session: None" in stateless mode 未關閉

enhancement P3

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

modelcontextprotocol/python-sdk#2329 · 1 則留言 · 2026年3月22日建立
Don't override client_metadata.scopes if they are already set 未關閉

auth enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2317 · 5 則留言 · 2026年3月20日建立
Mark SSE transport as deprecated 未關閉

improves sdk consistency improves spec compliance P3 v2

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

modelcontextprotocol/python-sdk#2278 · 1 則留言 · 2026年3月11日建立
pywin32 installation fails on Windows — hard dep only needed for client stdio, but pulled in for all users via eager import in __init__.py 未關閉

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2233 · 3 則留言 · 2026年3月6日建立
Bug: validate_scope rejects client scopes when required scopes in None 未關閉

auth bug P2 ready for work

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

modelcontextprotocol/python-sdk#2216 · 5 則留言 · 2026年3月5日建立
Type the MCPServer handler pipeline: tool/resource/prompt return types 未關閉

enhancement v2

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

modelcontextprotocol/python-sdk#2202 · 2026年3月2日建立
MCPServer handlers should raise exceptions, not return error objects 未關閉

enhancement v2

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

modelcontextprotocol/python-sdk#2153 · 2026年2月27日建立
Active Streamable HTTP sessions are not terminated during shutdown 未關閉

bug P2 ready for work

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

modelcontextprotocol/python-sdk#2150 · 3 則留言 · 2026年2月26日建立
Add wildcard pattern support for `allowed_hosts` in transport security 未關閉

enhancement needs confirmation

modelcontextprotocol/python-sdk#2141 · 1 則留言 · 已指派 1 人 · 2026年2月25日建立
Allow `OAuthClientProvider` to accept a pre-configured auth server URL 未關閉

auth enhancement needs confirmation

modelcontextprotocol/python-sdk#2121 · 已指派 1 人 · 2026年2月21日建立
Support MCP client session resumption (sessionId reuse) in Python SDK 未關閉

enhancement P2 v2

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

modelcontextprotocol/python-sdk#2116 · 2 則留言 · 1 個 reaction · 2026年2月20日建立
ExceptionGroup wrapping obscures real errors from task groups 未關閉

bug P1 v2

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

modelcontextprotocol/python-sdk#2114 · 3 則留言 · 2 個 reaction · 2026年2月19日建立
HTTP transport swallows non-2xx status codes causing client to hang 未關閉

bug P1 v2

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

modelcontextprotocol/python-sdk#2110 · 7 則留言 · 2 個 reaction · 2026年2月19日建立
Expose session, auth, and transport information on handler Context 未關閉

enhancement P1 v2

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

modelcontextprotocol/python-sdk#2098 · 1 則留言 · 2026年2月19日建立

modelcontextprotocol/python-sdk

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