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ả

49 issue phù hợp cho người mới đang mở

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
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
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 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
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
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
[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
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
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
[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
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
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 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
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
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
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
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
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
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
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
WWW-Authenticate parsing matches a field name as a substring of another auth-param Đang mở

auth bug P2 v2

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

modelcontextprotocol/python-sdk#3009 · 2 bình luận · Mở ngày 27/6/2026
[Bug] check_capability does not validate elicitation sub-capabilities (form/url) Đang mở

bug needs confirmation P2 v2

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

modelcontextprotocol/python-sdk#2965 · 2 bình luận · Mở ngày 25/6/2026
dict[str, T] tool return types lose Annotated/Field metadata in output schema Đang mở

bug P3 v2

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

modelcontextprotocol/python-sdk#2935 · 2 bình luận · Mở ngày 20/6/2026
`simple-auth` is not working as expected Đang mở

auth bug P2

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

modelcontextprotocol/python-sdk#2826 · Mở ngày 10/6/2026
OAuth handler doesn't support redirect URLs with params Đang mở

auth bug P2

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

modelcontextprotocol/python-sdk#2776 · 2 bình luận · Mở ngày 3/6/2026
streamable_http client does not send `Origin` header → rejected with 403 by spec-compliant servers (e.g. go-sdk `CrossOriginProtection`) Đang mở

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2727 · 3 bình luận · Mở ngày 30/5/2026
`ClientSessionGroup` attempts to use capabilities that were not advertised Đang mở

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2689 · 3 bình luận · Mở ngày 26/5/2026
Return 405 on GET when stateless_http=True Đang mở

bug P2

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

modelcontextprotocol/python-sdk#2474 · 4 bình luận · 2 reaction · Mở ngày 19/4/2026
Windows: TextIOWrapper in stdio_server() emits CRLF instead of LF, corrupting newline-delimited JSON messages Đang mở

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2433 · 9 bình luận · Mở ngày 13/4/2026
McpError is not pickle-safe and fails to unpickle Đang mở

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2431 · 9 bình luận · Mở ngày 13/4/2026
StreamableHTTP client: _handle_reconnection resets attempt counter to 0, causing infinite retry loop Đang mở

bug P2

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

modelcontextprotocol/python-sdk#2393 · 2 bình luận · Mở ngày 5/4/2026
ClientSession: add public API for updating callbacks after initialization Đang mở

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2379 · 4 bình luận · Mở ngày 30/3/2026
Don't override client_metadata.scopes if they are already set Đang mở

auth enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2317 · 5 bình luận · Mở ngày 20/3/2026
Bug: validate_scope rejects client scopes when required scopes in None Đang mở

auth bug P2 ready for work

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

modelcontextprotocol/python-sdk#2216 · 5 bình luận · Mở ngày 5/3/2026
Using transport="stdio" closes real stdio, causing ValueError after server exits Đang mở

bug good first issue P3

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

modelcontextprotocol/python-sdk#1933 · 8 bình luận · Mở ngày 22/1/2026
ClientAuthenticator ignores token_endpoint_auth_method="none" when client_secret is stored Đang mở

auth bug needs confirmation needs decision P2

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

modelcontextprotocol/python-sdk#1842 · 6 bình luận · Mở ngày 8/1/2026
More control over stderr in stdio client Đang mở

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#1806 · 1 bình luận · Mở ngày 19/12/2025
ServerSession methods (create_message, elicit_form) don't expose progress_callback parameter Đang mở

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#1671 · 2 bình luận · Mở ngày 25/11/2025
ClientDisconnect returns HTTP 500 Đang mở

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1648 · 6 bình luận · 1 reaction · Mở ngày 20/11/2025
Improve docs on how to use `instructions` on `InitializeResult` Đang mở

documentation P1 ready for work

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

modelcontextprotocol/python-sdk#1464 · 4 bình luận · 1 reaction · Mở ngày 10/10/2025
Don’t use shell=True in mcp dev subprocess on Windows (command injection risk) Đang mở

bug fix proposed P1 ready for work

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

modelcontextprotocol/python-sdk#1257 · 3 bình luận · Mở ngày 10/8/2025
[docs] How to run FastMCP with args or env vars? Đang mở

documentation P2 ready for work

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

modelcontextprotocol/python-sdk#339 · 3 bình luận · 1 reaction · Mở ngày 21/3/2025

modelcontextprotocol/python-sdk

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