modelcontextprotocol/python-sdk

The official Python SDK for Model Context Protocol servers and clients

Estrelas: 24.3k
Forks: 4k
Issues abertas para iniciantes: 50
Issues indexadas: 258
Merge médio: 1d 16h
PRs com merge (30d): 25

Linguagem predominante: Python
Licença: MIT
Último push no GitHub: 16/9/2026
Última indexação: 20/9/2026
Guia de contribuição: Guia de contribuição
Código de conduta: Código de conduta
Labels para iniciantes: good first issue help wanted

Para iniciantes Tudo

Abertas Todas

[v2] modern streamable HTTP watch_disconnect can busy-loop and peg a CPU core Aberta

v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 86/100

modelcontextprotocol/python-sdk#3439 · 3 comentários · Aberta em 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 Aberta

v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3437 · 5 comentários · Aberta em 3/9/2026
In-process callback failures break tool calls and notification sends Aberta

v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 84/100

modelcontextprotocol/python-sdk#3434 · 1 comentário · Aberta em 3/9/2026
coerce_request_id() folds non-canonical numeric strings, conflating wire-distinct JSON-RPC ids Aberta

v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100

modelcontextprotocol/python-sdk#3432 · 4 comentários · Aberta em 2/9/2026
test_safe_join_rejects_symlink_escape fails on Windows without elevation or Developer Mode Aberta

v2

Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100

modelcontextprotocol/python-sdk#3408 · 3 comentários · Aberta em 28/8/2026
Tool input schemas carry a pydantic-derived title on every property Aberta

v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 52/100

modelcontextprotocol/python-sdk#3391 · 5 comentários · Aberta em 25/8/2026
[v2] Expose request cancellation on MCPServer tool Context Aberta

v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3389 · 1 comentário · Aberta em 25/8/2026
A tool returning a non-finite float puts invalid JSON in the text content block Aberta

v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3385 · 1 comentário · Aberta em 25/8/2026
ClientSessionGroup raises KeyError when a server exposes no tools, resources or prompts Aberta

v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 70/100

modelcontextprotocol/python-sdk#3384 · 2 comentários · Aberta em 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) Aberta

v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100

modelcontextprotocol/python-sdk#3382 · 4 comentários · Aberta em 25/8/2026
pyjwt[crypto] as an unconditional dependency blocks installation on platforms without a cryptography wheel (e.g. Windows on ARM) Aberta

v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100

modelcontextprotocol/python-sdk#3373 · 6 comentários · Aberta em 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) Aberta

v1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 55/100

modelcontextprotocol/python-sdk#3358 · 6 comentários · Aberta em 21/8/2026
[v2] Allow MCPServer to disable subscriptions/listen Aberta

spec-2026-07-28 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3357 · 5 comentários · 4 reações · Aberta em 21/8/2026
Server.call_tool()'s input-validation error result discards jsonschema.ValidationError's structured fields, leaving only free-text prose Aberta

v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 55/100

modelcontextprotocol/python-sdk#3351 · 1 comentário · Aberta em 21/8/2026
Client treats JSON-null structuredContent as missing, skipping outputSchema validation Aberta

spec-2026-07-28 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100

modelcontextprotocol/python-sdk#3345 · 2 comentários · Aberta em 20/8/2026
Prompt validation errors are logged with an unnecessary traceback Aberta

v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100

modelcontextprotocol/python-sdk#3342 · 2 comentários · Aberta em 20/8/2026
A tool returning a non-finite float fails on the client with an error naming the tool Aberta

v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 72/100

modelcontextprotocol/python-sdk#3341 · 2 comentários · Aberta em 20/8/2026
Windows MCP SSH stdio transport closes after initialize when PROGRAMDATA is missing from inherited environment Aberta

v1 v2

Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 25/100

modelcontextprotocol/python-sdk#3335 · 1 comentário · Aberta em 19/8/2026
Add add_resource_template() to MCPServer Aberta

v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3333 · 1 comentário · Aberta em 19/8/2026
[v2] Expose the SSE max_event_size setting in Streamable HTTP clients Aberta

v2

modelcontextprotocol/python-sdk#3332 · 7 comentários · 1 responsável · Aberta em 18/8/2026
streamable-http client: no size bound before JSONRPCMessage.model_validate_json — one large server message can OOM the client Aberta

v1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 48/100

modelcontextprotocol/python-sdk#3330 · 2 comentários · Aberta em 18/8/2026
docs: no guidance for supporting SDK 1.x and 2.x at the same time Aberta

v2

Dificuldade 2/5 Meio dia Facilidade para iniciantes 62/100

modelcontextprotocol/python-sdk#3309 · 10 comentários · Aberta em 14/8/2026
Streamable HTTP clean EOF reconnects can exceed the request retry budget Aberta

bug needs confirmation P2 v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 88/100

modelcontextprotocol/python-sdk#3307 · 5 comentários · Aberta em 14/8/2026
A tool returning an empty list produces a CallToolResult with zero content blocks Aberta

enhancement needs decision P2 v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 55/100

modelcontextprotocol/python-sdk#3305 · 1 comentário · Aberta em 13/8/2026
check_resource_allowed(): path matching skips dot-segment/percent-encoding normalization (auth-boundary bypass) Aberta

auth bug needs confirmation P2 v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3303 · 4 comentários · Aberta em 13/8/2026
find_context_parameter treats a Context return annotation as a parameter Aberta

P3 v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100

modelcontextprotocol/python-sdk#3298 · 5 comentários · Aberta em 12/8/2026
resource_url_from_server_url preserves explicit default ports Aberta

P3 v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100

modelcontextprotocol/python-sdk#3297 · 1 comentário · Aberta em 12/8/2026
docs: clarify when Client(raise_exceptions=True) actually raises Aberta

P3 v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 72/100

modelcontextprotocol/python-sdk#3287 · 1 comentário · Aberta em 11/8/2026
Authentication in High Level MCPServer Aberta

P3 question v1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 38/100

modelcontextprotocol/python-sdk#3283 · 3 comentários · Aberta em 11/8/2026
streamable_http (legacy mode): early response.aclose() discards a TCP connection per JSON-RPC exchange — deterministic reproduction for #2707 Aberta

bug P2 v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 76/100

modelcontextprotocol/python-sdk#3281 · 1 comentário · Aberta em 11/8/2026
New example: examples/servers/admission-gate — a real approve/deny ServerMiddleware demo Aberta

documentation P3 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 72/100

modelcontextprotocol/python-sdk#3272 · 4 comentários · Aberta em 8/8/2026
Mcp-Name accepts an orphan header, while Mcp-Param-* rejects it as a routing spoof Aberta

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

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 42/100

modelcontextprotocol/python-sdk#3269 · 1 comentário · Aberta em 8/8/2026
`handle_get_stream` reconnects indefinitely when the server ends the GET stream normally (`attempt = 0` defeats `MAX_RECONNECTION_ATTEMPTS`) Aberta

P2 v1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 55/100

modelcontextprotocol/python-sdk#3257 · 1 comentário · Aberta em 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 Aberta

bug P1 v1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3256 · 1 comentário · Aberta em 5/8/2026
[v2] MCPServer reports empty experimental capabilities as {} via initialize but None via server/discover Aberta

P2 spec-2026-07-28 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 52/100

modelcontextprotocol/python-sdk#3254 · 1 comentário · Aberta em 5/8/2026
OAuthClientProvider._initialize() breaks transparent refresh: missing update_token_expiry + missing oauth_metadata load Aberta

P1 v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 70/100

modelcontextprotocol/python-sdk#3250 · Aberta em 4/8/2026
OAuth token refresh hits the wrong endpoint when the auth server lives under a path Aberta

P1 v1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 48/100

modelcontextprotocol/python-sdk#3240 · 2 comentários · Aberta em 3/8/2026
Expose create_mcp_http_client and McpHttpClientFactory as public API (2.0 made them private-only) Aberta

P1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3238 · 4 comentários · Aberta em 3/8/2026
Parameterized Context loses request state in resource and prompt handlers Aberta

P1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 55/100

modelcontextprotocol/python-sdk#3235 · 2 comentários · Aberta em 1/8/2026
Client-side support for the tasks extension (io.modelcontextprotocol/tasks, SEP-2663) Aberta

P2 spec-2026-07-28 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 52/100

modelcontextprotocol/python-sdk#3226 · 3 comentários · Aberta em 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 Aberta

P2 v1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 25/100

modelcontextprotocol/python-sdk#3209 · 1 comentário · Aberta em 29/7/2026
[v2] JSON-RPC error responses leave client OpenTelemetry spans UNSET Aberta

bug needs confirmation P2 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 76/100

modelcontextprotocol/python-sdk#3174 · 9 comentários · Aberta em 26/7/2026
Fix Streamable HTTP Accept header quality-factor handling Aberta

bug needs confirmation P3 v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 68/100

modelcontextprotocol/python-sdk#3154 · 1 comentário · Aberta em 23/7/2026
Deeply-nested-body test fails on macOS: rejected as INVALID_REQUEST (-32600) instead of PARSE_ERROR (-32700) Aberta

bug P3 spec-2026-07-28 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 58/100

modelcontextprotocol/python-sdk#3146 · Aberta em 22/7/2026
Add `ClientSession.register_tool_schema()` for dynamic tool discovery patterns Aberta

enhancement needs decision P3 v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100

modelcontextprotocol/python-sdk#3145 · 3 comentários · Aberta em 22/7/2026
OAuth client sends client_id in token body under client_secret_basic (strict servers reject as multiple auth methods) Aberta

auth bug needs confirmation P1 v1 v2

Dificuldade 4/5 3-5 dias Facilidade para iniciantes 48/100

modelcontextprotocol/python-sdk#3138 · 6 comentários · Aberta em 21/7/2026
perf: JSONRPCMessage smart union scores all four branches on every inbound message Aberta

enhancement needs decision P3 v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 25/100

modelcontextprotocol/python-sdk#3136 · Aberta em 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) Aberta

bug needs confirmation P2 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 86/100

modelcontextprotocol/python-sdk#3126 · 2 comentários · Aberta em 18/7/2026
RequireAuthMiddleware omits RFC 6750 scope in WWW-Authenticate on 401/403 Aberta

auth bug needs confirmation P2 v1 v2

Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100

modelcontextprotocol/python-sdk#3103 · 2 comentários · 4 reações · Aberta em 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 Aberta

bug needs confirmation P2 v1 v2

Dificuldade 3/5 1-2 dias Facilidade para iniciantes 58/100

modelcontextprotocol/python-sdk#3102 · 5 comentários · Aberta em 16/7/2026

Mostrando os 100 mais recentes

Esta página lista apenas o que foi indexado mais recentemente. O filtro avançado tem o inventário completo, refinado por linguagem, dificuldade e duração.

Abrir o filtro avançado

modelcontextprotocol/python-sdk

Mostrando os 100 mais recentes

Receba novas issues na sua caixa de entrada