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

適合新手全部

未關閉全部

49 個適合新手的 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日建立
pkg_version() in Server.create_initialization_options doesn't guard against importlib.metadata.version() returning None 未關閉

v1

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

modelcontextprotocol/python-sdk#3487 · 3 則留言 · 2026年9月9日建立
Simplify `src/mcp/shared/metadata_utils.py::get_display_name` logic. 未關閉

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

modelcontextprotocol/python-sdk#3480 · 1 則留言 · 2026年9月8日建立
[Bug] Client sends empty _meta:{} on every request; strict servers (Meta Ads MCP) reject with HTTP 400 未關閉

v2

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

modelcontextprotocol/python-sdk#3473 · 2 則留言 · 2026年9月8日建立
StreamableHTTP: a client disconnect while reading the POST body is logged as an exception and answered 500 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3469 · 2 則留言 · 2026年9月7日建立
check_resource_allowed treats /api/../admin as under /api 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3464 · 3 則留言 · 2026年9月6日建立
DNS rebinding :* allowlist matches Host/Origin suffixes that are not ports 未關閉

v1 v2

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

modelcontextprotocol/python-sdk#3463 · 2 則留言 · 2026年9月6日建立
[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日建立
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日建立
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 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日建立
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日建立
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日建立
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日建立
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日建立
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日建立
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日建立
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日建立
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日建立
`simple-auth` is not working as expected 未關閉

auth bug P2

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

modelcontextprotocol/python-sdk#2826 · 2026年6月10日建立
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日建立
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日建立
`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日建立
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日建立
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日建立
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日建立
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日建立
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日建立
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日建立
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日建立
Using transport="stdio" closes real stdio, causing ValueError after server exits 未關閉

bug good first issue P3

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

modelcontextprotocol/python-sdk#1933 · 8 則留言 · 2026年1月22日建立
ClientAuthenticator ignores token_endpoint_auth_method="none" when client_secret is stored 未關閉

auth bug needs confirmation needs decision P2

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

modelcontextprotocol/python-sdk#1842 · 6 則留言 · 2026年1月8日建立
More control over stderr in stdio client 未關閉

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#1806 · 1 則留言 · 2025年12月19日建立
ServerSession methods (create_message, elicit_form) don't expose progress_callback parameter 未關閉

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#1671 · 2 則留言 · 2025年11月25日建立
ClientDisconnect returns HTTP 500 未關閉

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1648 · 6 則留言 · 1 個 reaction · 2025年11月20日建立
Improve docs on how to use `instructions` on `InitializeResult` 未關閉

documentation P1 ready for work

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

modelcontextprotocol/python-sdk#1464 · 4 則留言 · 1 個 reaction · 2025年10月10日建立
Don’t use shell=True in mcp dev subprocess on Windows (command injection risk) 未關閉

bug fix proposed P1 ready for work

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

modelcontextprotocol/python-sdk#1257 · 3 則留言 · 2025年8月10日建立
[docs] How to run FastMCP with args or env vars? 未關閉

documentation P2 ready for work

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

modelcontextprotocol/python-sdk#339 · 3 則留言 · 1 個 reaction · 2025年3月21日建立

modelcontextprotocol/python-sdk

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