modelcontextprotocol/python-sdk

The official Python SDK for Model Context Protocol servers and clients

Star: 24.3k
Fork: 4k
Issue cho người mới đang mở: 49
Issue đã lập chỉ mục: 251
Merge trung bình: 1 ngày 11 giờ
Pull request đã merge (30 ngày): 30

Ngôn ngữ chính: Python
Giấy phép: MIT
Lần push lên GitHub gần nhất: 16/9/2026
Lập chỉ mục gần nhất: 20/9/2026
Hướng dẫn đóng góp: Hướng dẫn đóng góp
Quy tắc ứng xử: Quy tắc ứng xử
Label cho người mới: good first issue help wanted

Đang mở Tất cả

A tool returning a non-finite float puts invalid JSON in the text content block Đang mở

v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100

modelcontextprotocol/python-sdk#3385 · 1 bình luận · Mở ngày 25/8/2026
ClientSessionGroup raises KeyError when a server exposes no tools, resources or prompts Đang mở

v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 70/100

modelcontextprotocol/python-sdk#3384 · 2 bình luận · Mở ngày 25/8/2026
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) Đang mở

v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100

modelcontextprotocol/python-sdk#3382 · 4 bình luận · Mở ngày 25/8/2026
pyjwt[crypto] as an unconditional dependency blocks installation on platforms without a cryptography wheel (e.g. Windows on ARM) Đang mở

v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100

modelcontextprotocol/python-sdk#3373 · 6 bình luận · Mở ngày 24/8/2026
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) Đang mở

v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100

modelcontextprotocol/python-sdk#3358 · 6 bình luận · Mở ngày 21/8/2026
[v2] Allow MCPServer to disable subscriptions/listen Đang mở

spec-2026-07-28 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 68/100

modelcontextprotocol/python-sdk#3357 · 5 bình luận · 4 reaction · Mở ngày 21/8/2026
Server.call_tool()'s input-validation error result discards jsonschema.ValidationError's structured fields, leaving only free-text prose Đang mở

v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100

modelcontextprotocol/python-sdk#3351 · 1 bình luận · Mở ngày 21/8/2026
Client treats JSON-null structuredContent as missing, skipping outputSchema validation Đang mở

spec-2026-07-28 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100

modelcontextprotocol/python-sdk#3345 · 2 bình luận · Mở ngày 20/8/2026
Prompt validation errors are logged with an unnecessary traceback Đang mở

v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100

modelcontextprotocol/python-sdk#3342 · 2 bình luận · Mở ngày 20/8/2026
A tool returning a non-finite float fails on the client with an error naming the tool Đang mở

v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 72/100

modelcontextprotocol/python-sdk#3341 · 2 bình luận · Mở ngày 20/8/2026
Windows MCP SSH stdio transport closes after initialize when PROGRAMDATA is missing from inherited environment Đang mở

v1 v2

Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 25/100

modelcontextprotocol/python-sdk#3335 · 1 bình luận · Mở ngày 19/8/2026
Add add_resource_template() to MCPServer Đang mở

v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100

modelcontextprotocol/python-sdk#3333 · 1 bình luận · Mở ngày 19/8/2026
[v2] Expose the SSE max_event_size setting in Streamable HTTP clients Đang mở

v2

modelcontextprotocol/python-sdk#3332 · 7 bình luận · 1 người được giao · Mở ngày 18/8/2026
streamable-http client: no size bound before JSONRPCMessage.model_validate_json — one large server message can OOM the client Đang mở

v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100

modelcontextprotocol/python-sdk#3330 · 2 bình luận · Mở ngày 18/8/2026
docs: no guidance for supporting SDK 1.x and 2.x at the same time Đang mở

v2

Độ khó 2/5 Nửa ngày Mức phù hợp với người mới 62/100

modelcontextprotocol/python-sdk#3309 · 10 bình luận · Mở ngày 14/8/2026
Streamable HTTP clean EOF reconnects can exceed the request retry budget Đang mở

bug needs confirmation P2 v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 88/100

modelcontextprotocol/python-sdk#3307 · 5 bình luận · Mở ngày 14/8/2026
A tool returning an empty list produces a CallToolResult with zero content blocks Đang mở

enhancement needs decision P2 v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 55/100

modelcontextprotocol/python-sdk#3305 · 1 bình luận · Mở ngày 13/8/2026
check_resource_allowed(): path matching skips dot-segment/percent-encoding normalization (auth-boundary bypass) Đang mở

auth bug needs confirmation P2 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100

modelcontextprotocol/python-sdk#3303 · 4 bình luận · Mở ngày 13/8/2026
find_context_parameter treats a Context return annotation as a parameter Đang mở

P3 v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100

modelcontextprotocol/python-sdk#3298 · 5 bình luận · Mở ngày 12/8/2026
resource_url_from_server_url preserves explicit default ports Đang mở

P3 v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100

modelcontextprotocol/python-sdk#3297 · 1 bình luận · Mở ngày 12/8/2026
docs: clarify when Client(raise_exceptions=True) actually raises Đang mở

P3 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 72/100

modelcontextprotocol/python-sdk#3287 · 1 bình luận · Mở ngày 11/8/2026
Authentication in High Level MCPServer Đang mở

P3 question v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 38/100

modelcontextprotocol/python-sdk#3283 · 3 bình luận · Mở ngày 11/8/2026
streamable_http (legacy mode): early response.aclose() discards a TCP connection per JSON-RPC exchange — deterministic reproduction for #2707 Đang mở

bug P2 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 76/100

modelcontextprotocol/python-sdk#3281 · 1 bình luận · Mở ngày 11/8/2026
New example: examples/servers/admission-gate — a real approve/deny ServerMiddleware demo Đang mở

documentation P3 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 72/100

modelcontextprotocol/python-sdk#3272 · 4 bình luận · Mở ngày 8/8/2026
Mcp-Name accepts an orphan header, while Mcp-Param-* rejects it as a routing spoof Đang mở

improves spec compliance P3 spec-2026-07-28 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 42/100

modelcontextprotocol/python-sdk#3269 · 1 bình luận · Mở ngày 8/8/2026
`handle_get_stream` reconnects indefinitely when the server ends the GET stream normally (`attempt = 0` defeats `MAX_RECONNECTION_ATTEMPTS`) Đang mở

P2 v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100

modelcontextprotocol/python-sdk#3257 · 1 bình luận · Mở ngày 5/8/2026
OAuth client can never recover from an expired DCR client secret — even though the SDK's own server issues and enforces one Đang mở

bug P1 v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 68/100

modelcontextprotocol/python-sdk#3256 · 1 bình luận · Mở ngày 5/8/2026
[v2] MCPServer reports empty experimental capabilities as {} via initialize but None via server/discover Đang mở

P2 spec-2026-07-28 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 52/100

modelcontextprotocol/python-sdk#3254 · 1 bình luận · Mở ngày 5/8/2026
OAuthClientProvider._initialize() breaks transparent refresh: missing update_token_expiry + missing oauth_metadata load Đang mở

P1 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 70/100

modelcontextprotocol/python-sdk#3250 · Mở ngày 4/8/2026
OAuth token refresh hits the wrong endpoint when the auth server lives under a path Đang mở

P1 v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100

modelcontextprotocol/python-sdk#3240 · 2 bình luận · Mở ngày 3/8/2026
Expose create_mcp_http_client and McpHttpClientFactory as public API (2.0 made them private-only) Đang mở

P1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100

modelcontextprotocol/python-sdk#3238 · 4 bình luận · Mở ngày 3/8/2026
Parameterized Context loses request state in resource and prompt handlers Đang mở

P1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 55/100

modelcontextprotocol/python-sdk#3235 · 2 bình luận · Mở ngày 1/8/2026
Client-side support for the tasks extension (io.modelcontextprotocol/tasks, SEP-2663) Đang mở

P2 spec-2026-07-28 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 52/100

modelcontextprotocol/python-sdk#3226 · 3 bình luận · Mở ngày 30/7/2026
Bug: OAuth provider holds context.lock for the whole request, so the standalone GET SSE stream stalls the first tools/call by ~15s Đang mở

P2 v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 25/100

modelcontextprotocol/python-sdk#3209 · 1 bình luận · Mở ngày 29/7/2026
[v2] JSON-RPC error responses leave client OpenTelemetry spans UNSET Đang mở

bug needs confirmation P2 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 76/100

modelcontextprotocol/python-sdk#3174 · 9 bình luận · Mở ngày 26/7/2026
Fix Streamable HTTP Accept header quality-factor handling Đang mở

bug needs confirmation P3 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100

modelcontextprotocol/python-sdk#3154 · 1 bình luận · Mở ngày 23/7/2026
Deeply-nested-body test fails on macOS: rejected as INVALID_REQUEST (-32600) instead of PARSE_ERROR (-32700) Đang mở

bug P3 spec-2026-07-28 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 58/100

modelcontextprotocol/python-sdk#3146 · Mở ngày 22/7/2026
Add `ClientSession.register_tool_schema()` for dynamic tool discovery patterns Đang mở

enhancement needs decision P3 v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100

modelcontextprotocol/python-sdk#3145 · 3 bình luận · Mở ngày 22/7/2026
OAuth client sends client_id in token body under client_secret_basic (strict servers reject as multiple auth methods) Đang mở

auth bug needs confirmation P1 v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 48/100

modelcontextprotocol/python-sdk#3138 · 6 bình luận · Mở ngày 21/7/2026
perf: JSONRPCMessage smart union scores all four branches on every inbound message Đang mở

enhancement needs decision P3 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 25/100

modelcontextprotocol/python-sdk#3136 · Mở ngày 19/7/2026
Dispatcher mints a request id already used by a completed caller-supplied request (spec: ids MUST NOT be reused in a session) Đang mở

bug needs confirmation P2 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 86/100

modelcontextprotocol/python-sdk#3126 · 2 bình luận · Mở ngày 18/7/2026
RequireAuthMiddleware omits RFC 6750 scope in WWW-Authenticate on 401/403 Đang mở

auth bug needs confirmation P2 v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100

modelcontextprotocol/python-sdk#3103 · 2 bình luận · 4 reaction · Mở ngày 16/7/2026
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 Đang mở

bug needs confirmation P2 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 58/100

modelcontextprotocol/python-sdk#3102 · 5 bình luận · Mở ngày 16/7/2026
Generated output schema uses Pydantic's validation shape while structured output uses its serialization shape Đang mở

bug needs confirmation P2 v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 52/100

modelcontextprotocol/python-sdk#3100 · 2 bình luận · Mở ngày 16/7/2026
Field alias is published in the tool schema but forwarded as an invalid Python keyword Đang mở

bug needs confirmation P2 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100

modelcontextprotocol/python-sdk#3099 · 7 bình luận · Mở ngày 16/7/2026
Heavy sync init work (e.g. local ML models) starves stdio initialize/tool calls even with threadpool offload -- Windows GIL contention Đang mở

documentation enhancement needs decision P3 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 48/100

modelcontextprotocol/python-sdk#3089 · 3 bình luận · Mở ngày 12/7/2026
FastMCP tool argument models silently ignore unknown/misspelled arguments (extra=ignore default) Đang mở

enhancement needs decision P2 v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100

modelcontextprotocol/python-sdk#3067 · 1 bình luận · 1 reaction · Mở ngày 6/7/2026
[v2] RFC 9728 PRM URLs and resource matching drop query components Đang mở

auth bug needs confirmation P2 v1 v2

Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 74/100

modelcontextprotocol/python-sdk#3065 · 2 bình luận · Mở ngày 6/7/2026
streamable HTTP (stateful): concurrent requests with duplicate JSON-RPC ids cross-wire responses — one request receives another's payload, the other hangs Đang mở

bug P2 v1 v2

Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 70/100

modelcontextprotocol/python-sdk#3060 · 5 bình luận · 1 reaction · Mở ngày 3/7/2026
FuncMetadata.pre_parse_json mis-detects str | None as non-string and corrupts JSON-looking string arguments Đang mở

bug P2 v1 v2

Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100

modelcontextprotocol/python-sdk#3055 · 2 bình luận · Mở ngày 2/7/2026

Đang hiển thị 100 mục mới nhất

Trang này chỉ liệt kê những gì được lập chỉ mục gần đây. Bộ lọc nâng cao có toàn bộ kho, thu hẹp theo ngôn ngữ, độ khó và thời lượng.

Mở bộ lọc nâng cao

modelcontextprotocol/python-sdk

Đang hiển thị 100 mục mới nhất

Nhận issue mới trong hộp thư của bạn