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 发到你的邮箱