modelcontextprotocol/python-sdk

在 GitHub 查看

The official Python SDK for Model Context Protocol servers and clients

星标: 24.3k
派生: 4k
开放的新手 issue: 49
已索引 issue: 245
平均合并: 1 天 19 分钟
30 天内合并 PR: 29

主要语言: Python
许可证: MIT
最近 GitHub push: 2026年9月16日
最近索引: 2026年9月20日
贡献指南: 贡献指南
行为准则: 行为准则
新手标签: good first issue help wanted

适合新手全部

未关闭全部

Malformed requests get -32602 where JSON-RPC 2.0 requires -32600 (non-Request body) and -32601 (unknown method) 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3557 · 1 条评论 · 2026年9月21日创建
Streamable HTTP client treats 404 as terminal instead of re-initializing, as the spec requires 未关闭

v1 v2

难度 4/5 3-5 天新手友好度 58/100

modelcontextprotocol/python-sdk#3556 · 2026年9月21日创建
Structured tool output: `-> bytes` return crashes with a generic error on non-UTF-8 payloads instead of returning the advertised base64/binary string 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3554 · 4 条评论 · 2026年9月21日创建
stdio server ignores the first two Ctrl+C presses at a terminal (blocked stdin worker thread) 未关闭

v1 v2

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/python-sdk#3551 · 1 个 reaction · 2026年9月20日创建
How can I manage resource across multiple tool calls during one session? 未关闭

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/python-sdk#3549 · 2026年9月20日创建
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日创建
tests/client/test_client.py: 14 failures on Windows — AttributeError: '...Result' object has no attribute '_meta' 未关闭

难度 3/5 1-2 天新手友好度 75/100

modelcontextprotocol/python-sdk#3544 · 1 条评论 · 2026年9月18日创建
OAuth client sends discovery/registration requests with no User-Agent, so WAF-fronted servers (Cloudflare) 403 the whole flow 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3531 · 1 条评论 · 2026年9月18日创建
A resource template with a non-ASCII or space literal is advertised but can never be read 未关闭

v1 v2

难度 3/5 1-2 天新手友好度 45/100

modelcontextprotocol/python-sdk#3526 · 1 条评论 · 2026年9月18日创建
Streamable HTTP client stays closed after an interrupted response and raises ExceptionGroup on cleanup 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3522 · 1 条评论 · 2026年9月17日创建
A tool with a *args or **kwargs parameter is registered with a schema it can never satisfy 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3514 · 1 条评论 · 2026年9月16日创建
ClientSession.call_tool issues a tools/list after every tools/call when the output-schema cache is empty — no opt-out; doubles round-trips on per-call sessions 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3513 · 1 条评论 · 2026年9月16日创建
Revocation requires client_secret to be present 未关闭

v1 v2

难度 1/5 1 小时以内新手友好度 91/100

modelcontextprotocol/python-sdk#3508 · 2 条评论 · 2026年9月15日创建
OAuth client: authorization URL is built with a second `?` when the advertised `authorization_endpoint` already carries a query (RFC 6749 §3.1) 未关闭

v1 v2

难度 2/5 1-3 小时新手友好度 35/100

modelcontextprotocol/python-sdk#3505 · 2 条评论 · 1 个 reaction · 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 client: the standalone GET stream advertises Accept: application/json but can only read text/event-stream, then gives up silently 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3503 · 1 条评论 · 2026年9月14日创建
Streamable HTTP: ASGI application returns before the full SSE body is sent 未关闭

v1 v2

难度 4/5 3-5 天新手友好度 50/100

modelcontextprotocol/python-sdk#3494 · 2 条评论 · 2026年9月11日创建
MCPServer serves subscriptions/listen and advertises listChanged=true unconditionally — hold-open streams pin serverless invocations to the platform timeout 未关闭

spec-2026-07-28 v2

难度 4/5 3-5 天新手友好度 57/100

modelcontextprotocol/python-sdk#3493 · 3 条评论 · 2026年9月11日创建
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日创建
ClientSessionGroup: a rejected connect_to_server leaves its transport running — the session is established before its components are validated 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3490 · 2 条评论 · 2026年9月10日创建
Is one-auth-configuration-per-server a deliberate constraint? 未关闭

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/python-sdk#3488 · 2026年9月9日创建
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日创建
Add SEP-2640 (Skills Extension) protocol support 未关闭

modelcontextprotocol/python-sdk#3486 · 2 个 reaction · 已指派 1 人 · 2026年9月9日创建
MCPServer has no x-mcp-header declaration mechanism and never validates one, so an invalid annotation is served happily and dropped by every client 未关闭

spec-2026-07-28 v2

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

modelcontextprotocol/python-sdk#3484 · 3 条评论 · 2026年9月9日创建
Client never retries after -32020 HeaderMismatch, and there is no public way to pre-load the x-mcp-header map (SEP-2243 client SHOULD/MAY both unimplemented) 未关闭

spec-2026-07-28 v2

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

modelcontextprotocol/python-sdk#3483 · 2 条评论 · 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日创建
Missing prompt-level _meta support in MCPServer.prompt() and Prompt model 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3476 · 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日创建
[v2] Add an end-to-end public-client PKCE server contract 未关闭

v1 v2

难度 4/5 3-5 天新手友好度 50/100

modelcontextprotocol/python-sdk#3472 · 1 条评论 · 2026年9月8日创建
# TypeScript npm install @modelcontextprotocol/sdk zod # Python pip install mcp 未关闭

难度 2/5 1-3 小时新手友好度 30/100

modelcontextprotocol/python-sdk#3471 · 1 条评论 · 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日创建
CallToolResult structuredContent is not alias-normalized to match outputSchema 未关闭

v1 v2

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

modelcontextprotocol/python-sdk#3467 · 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日创建
StdioServerParameters exposes no preexec_fn / rlimit / process-group hook for spawned MCP server subprocess 未关闭

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

modelcontextprotocol/python-sdk#3457 · 4 条评论 · 2026年9月6日创建
1.x: streamable_http client leaves a request unresolved when the SSE response stream ends without a response (fixed on 2.x by #3047 — backport request for v1.x) 未关闭

v1

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

modelcontextprotocol/python-sdk#3441 · 1 条评论 · 2026年9月4日创建
[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日创建

只显示最新的 100 条

这个页面只列出最近收录的部分。完整清单在高级筛选里，可以按语言、难度和预计耗时筛选。

前往高级筛选

精选适合新手参与的 GitHub issue 摘要。