modelcontextprotocol/python-sdk

Xem trên GitHub

The official Python SDK for Model Context Protocol servers and clients

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

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

Phù hợp cho người mới Tất cả

Đang mở Tất cả

Đã lập chỉ mục 241 issue đang mở

How can I manage resource across multiple tool calls during one session? Đang mở

Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100

modelcontextprotocol/python-sdk#3549 · Mở ngày 20/9/2026
Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3546 · 4 bình luận · Mở ngày 19/9/2026
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3545 · 1 bình luận · Mở ngày 18/9/2026
tests/client/test_client.py: 14 failures on Windows — AttributeError: '...Result' object has no attribute '_meta' Đang mở

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

modelcontextprotocol/python-sdk#3544 · 1 bình luận · Mở ngày 18/9/2026
OAuth client sends discovery/registration requests with no User-Agent, so WAF-fronted servers (Cloudflare) 403 the whole flow Đ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#3531 · 1 bình luận · Mở ngày 18/9/2026
A resource template with a non-ASCII or space literal is advertised but can never be read Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3526 · 1 bình luận · Mở ngày 18/9/2026
Streamable HTTP client stays closed after an interrupted response and raises ExceptionGroup on cleanup Đ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#3522 · 1 bình luận · Mở ngày 17/9/2026
A tool with a *args or **kwargs parameter is registered with a schema it can never satisfy Đ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#3514 · 1 bình luận · Mở ngày 16/9/2026
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 Đ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#3513 · 1 bình luận · Mở ngày 16/9/2026
Revocation requires client_secret to be present Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3508 · 2 bình luận · Mở ngày 15/9/2026
OAuth client: authorization URL is built with a second `?` when the advertised `authorization_endpoint` already carries a query (RFC 6749 §3.1) Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3505 · 2 bình luận · Mở ngày 15/9/2026
Does same-origin redirect enforcement break MCP servers behind a reverse proxy? Đang mở

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

modelcontextprotocol/python-sdk#3504 · Mở ngày 15/9/2026
streamable HTTP client: the standalone GET stream advertises Accept: application/json but can only read text/event-stream, then gives up silently Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3503 · 1 bình luận · Mở ngày 14/9/2026
Streamable HTTP: ASGI application returns before the full SSE body is sent Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3494 · 2 bình luận · Mở ngày 11/9/2026
MCPServer serves subscriptions/listen and advertises listChanged=true unconditionally — hold-open streams pin serverless invocations to the platform timeout Đ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 57/100

modelcontextprotocol/python-sdk#3493 · 3 bình luận · Mở ngày 11/9/2026
Streamable HTTP stateless servers hang clients on the listen-mode GET (_handle_get_request opens a hold-open SSE stream) Đ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#3492 · 1 bình luận · Mở ngày 11/9/2026
ClientSessionGroup: a rejected connect_to_server leaves its transport running — the session is established before its components are validated Đang mở

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#3490 · 2 bình luận · Mở ngày 10/9/2026
Is one-auth-configuration-per-server a deliberate constraint? Đang mở

Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100

modelcontextprotocol/python-sdk#3488 · Mở ngày 9/9/2026
pkg_version() in Server.create_initialization_options doesn't guard against importlib.metadata.version() returning None Đang mở

v1

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

modelcontextprotocol/python-sdk#3487 · 3 bình luận · Mở ngày 9/9/2026
Add SEP-2640 (Skills Extension) protocol support Đang mở

modelcontextprotocol/python-sdk#3486 · 2 reaction · 1 người được giao · Mở ngày 9/9/2026
MCPServer has no x-mcp-header declaration mechanism and never validates one, so an invalid annotation is served happily and dropped by every client Đ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 55/100

modelcontextprotocol/python-sdk#3484 · 3 bình luận · Mở ngày 9/9/2026
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) Đ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 52/100

modelcontextprotocol/python-sdk#3483 · 2 bình luận · Mở ngày 9/9/2026
Simplify `src/mcp/shared/metadata_utils.py::get_display_name` logic. Đang mở

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

modelcontextprotocol/python-sdk#3480 · 1 bình luận · Mở ngày 8/9/2026
Missing prompt-level _meta support in MCPServer.prompt() and Prompt model Đ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#3476 · 1 bình luận · Mở ngày 8/9/2026
[Bug] Client sends empty _meta:{} on every request; strict servers (Meta Ads MCP) reject with HTTP 400 Đang mở

v2

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

modelcontextprotocol/python-sdk#3473 · 2 bình luận · Mở ngày 8/9/2026
[v2] Add an end-to-end public-client PKCE server contract Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3472 · 1 bình luận · Mở ngày 8/9/2026
# TypeScript npm install @modelcontextprotocol/sdk zod # Python pip install mcp Đang mở

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

modelcontextprotocol/python-sdk#3471 · 1 bình luận · Mở ngày 8/9/2026
StreamableHTTP: a client disconnect while reading the POST body is logged as an exception and answered 500 Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3469 · 2 bình luận · Mở ngày 7/9/2026
CallToolResult structuredContent is not alias-normalized to match outputSchema Đang mở

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#3467 · 2 bình luận · Mở ngày 7/9/2026
check_resource_allowed treats /api/../admin as under /api Đ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#3464 · 3 bình luận · Mở ngày 6/9/2026
DNS rebinding :* allowlist matches Host/Origin suffixes that are not ports Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3463 · 2 bình luận · Mở ngày 6/9/2026
StdioServerParameters exposes no preexec_fn / rlimit / process-group hook for spawned MCP server subprocess Đang mở

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

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

v1

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

modelcontextprotocol/python-sdk#3441 · 1 bình luận · Mở ngày 4/9/2026
[v2] modern streamable HTTP watch_disconnect can busy-loop and peg a CPU core Đang mở

v2

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

modelcontextprotocol/python-sdk#3439 · 3 bình luận · Mở ngày 3/9/2026
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 Đ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#3437 · 5 bình luận · Mở ngày 3/9/2026
In-process callback failures break tool calls and notification sends Đang mở

v2

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

modelcontextprotocol/python-sdk#3434 · 1 bình luận · Mở ngày 3/9/2026
coerce_request_id() folds non-canonical numeric strings, conflating wire-distinct JSON-RPC ids Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3432 · 4 bình luận · Mở ngày 2/9/2026
test_safe_join_rejects_symlink_escape fails on Windows without elevation or Developer Mode Đang mở

v2

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

modelcontextprotocol/python-sdk#3408 · 3 bình luận · Mở ngày 28/8/2026
Tool input schemas carry a pydantic-derived title on every property Đang mở

v1 v2

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

modelcontextprotocol/python-sdk#3391 · 5 bình luận · Mở ngày 25/8/2026
[v2] Expose request cancellation on MCPServer tool Context Đ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#3389 · 1 bình luận · Mở ngày 25/8/2026
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

modelcontextprotocol/python-sdk

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