modelcontextprotocol/python-sdk

Ver no GitHub

The official Python SDK for Model Context Protocol servers and clients

Estrelas: 24.3k
Forks: 4k
Issues abertas para iniciantes: 17
Issues indexadas: 241
Merge médio: 1d 1h
PRs com merge (30d): 31

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

241 issues abertas indexadas

Deep JSON-RPC request over stdio logs a validation error and leaves the original request pending Aberta

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2751 · 1 comentário · Aberta em 1/6/2026
Stateful Streamable HTTP: in-session exceptions are masked as an empty -32603; real cause only in a separate "Session crashed" log Aberta

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2741 · 2 comentários · Aberta em 31/5/2026
streamable_http client does not send `Origin` header → rejected with 403 by spec-compliant servers (e.g. go-sdk `CrossOriginProtection`) Aberta

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2727 · 3 comentários · Aberta em 30/5/2026
FastMCP: streamable_http_app() silently breaks when BaseHTTPMiddleware is added Aberta

bug needs repro P3 potentially close

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

modelcontextprotocol/python-sdk#2702 · 5 comentários · Aberta em 27/5/2026
`ClientSessionGroup` attempts to use capabilities that were not advertised Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2689 · 3 comentários · Aberta em 26/5/2026
`OAuthClientInformationFull.redirect_uris`: pydantic strict-type-equality breaks `AnyUrl(x) != AnyHttpUrl(x)` round-trip Aberta

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2687 · 3 comentários · Aberta em 26/5/2026
FastMCP/stdio: in-flight tool responses dropped on stdin EOF when input is bash-redirected from a file Aberta

bug P2 ready for work

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

modelcontextprotocol/python-sdk#2678 · 8 comentários · Aberta em 25/5/2026
ClientSession receive loop swallows callback exceptions, replying "Invalid request parameters" to the server instead of propagating to the call_tool awaiter Aberta

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2673 · 4 comentários · Aberta em 24/5/2026
FastMCP.run(transport="stdio") produces noisy traceback on KeyboardInterrupt instead of clean exit Aberta

bug fix proposed P3 ready for work

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

modelcontextprotocol/python-sdk#2663 · 3 comentários · Aberta em 22/5/2026
Streamable HTTP server silently drops in-flight request when client reuses a JSON-RPC id Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2655 · 3 comentários · Aberta em 21/5/2026
mcp.server.fastmcp.FastMCP HTTP transport deadlocks after ~5 sequential client sessions on Windows (companion to PrefectHQ/fastmcp#4192) Aberta

bug needs repro

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

modelcontextprotocol/python-sdk#2653 · 3 comentários · Aberta em 21/5/2026
DCR registration accepts redirect_uris with non-HTTPS / non-loopback / fragmented schemes Aberta

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2629 · 1 comentário · Aberta em 18/5/2026
Add option to skip output validation for mcp client Aberta

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2626 · 3 comentários · Aberta em 17/5/2026
RequestResponder.__exit__ leaks CancelledError on cancelled request, killing the stdio receive loop Aberta

bug needs confirmation P2 potentially close

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

modelcontextprotocol/python-sdk#2610 · 3 comentários · Aberta em 15/5/2026
Duplicate `initialize` with changed parameters can overwrite `ServerSession.client_params` Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2605 · 4 comentários · Aberta em 15/5/2026
`ClientConfig` has inconsistent naming: `message_handler` should be `message_callback` Aberta

enhancement needs decision P3 v2

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

modelcontextprotocol/python-sdk#2588 · Aberta em 13/5/2026
Expose `schema_generator` on `FastMCP` for tool params schema generation Aberta

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2582 · Aberta em 13/5/2026
OAuth token refresh sends RFC 8707 resource parameter that Entra ID v2.0 rejects (AADSTS9010010) Aberta

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2578 · 6 comentários · Aberta em 12/5/2026
raise without from discards exception chain in 12 remaining sites Aberta

bug P3

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

modelcontextprotocol/python-sdk#2564 · 3 comentários · Aberta em 8/5/2026
Add `list_all_*` helpers to drain pagination Aberta

enhancement P3 v2

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

modelcontextprotocol/python-sdk#2556 · 3 comentários · Aberta em 8/5/2026
Split the core from the server and client implementations Aberta

enhancement needs decision P3 v2

Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 35/100

modelcontextprotocol/python-sdk#2486 · 4 comentários · Aberta em 21/4/2026
Return 405 on GET when stateless_http=True Aberta

bug P2

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

modelcontextprotocol/python-sdk#2474 · 4 comentários · 2 reações · Aberta em 19/4/2026
MCPServer unconditionally declares `prompts`, `resources`, `tools` capabilities on `initialize` Aberta

bug P2

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

modelcontextprotocol/python-sdk#2473 · Aberta em 19/4/2026
stdio_client crashes on malformed UTF-8 from child stdout instead of surfacing parse error Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2454 · 3 comentários · Aberta em 16/4/2026
Windows: TextIOWrapper in stdio_server() emits CRLF instead of LF, corrupting newline-delimited JSON messages Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2433 · 9 comentários · Aberta em 13/4/2026
Initialize call hangs forever if MCP server does not return a `Content-Type: text/plain` Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2432 · 3 comentários · Aberta em 13/4/2026
McpError is not pickle-safe and fails to unpickle Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2431 · 9 comentários · Aberta em 13/4/2026
[v1.x] Server-side outputSchema validation blocks tool error reporting (isError: true) Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2429 · 2 comentários · Aberta em 13/4/2026
Specific ToolNotFoundError for easier handling than ToolError in multi-tenant environments Aberta

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2422 · 4 comentários · Aberta em 10/4/2026
Bug: AssertionError: Request already responded to — cancellation race in v1.27.0 Aberta

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2416 · 14 comentários · Aberta em 9/4/2026
StreamableHTTP client: _handle_reconnection resets attempt counter to 0, causing infinite retry loop Aberta

bug P2

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

modelcontextprotocol/python-sdk#2393 · 2 comentários · Aberta em 5/4/2026
Inline $ref in tool inputSchema for LLM consumption (parity with typescript-sdk) Aberta

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2384 · 2 comentários · Aberta em 2/4/2026
ClientSession: add public API for updating callbacks after initialization Aberta

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2379 · 4 comentários · Aberta em 30/3/2026
Image/ImageContent serialization fails in stateless HTTP mode Aberta

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2376 · 3 comentários · 5 reações · Aberta em 29/3/2026
Design: future of `dependencies` parameter on MCPServer Aberta

enhancement needs decision P2 v2

Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 35/100

modelcontextprotocol/python-sdk#2354 · 2 comentários · 4 reações · Aberta em 26/3/2026
Add remove_prompt() and remove_resource() for parity with remove_tool() Aberta

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2331 · 4 comentários · Aberta em 22/3/2026
Improve log clarity for "Terminating session: None" in stateless mode Aberta

enhancement P3

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

modelcontextprotocol/python-sdk#2329 · 1 comentário · Aberta em 22/3/2026
Don't override client_metadata.scopes if they are already set Aberta

auth enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2317 · 5 comentários · Aberta em 20/3/2026
Mark SSE transport as deprecated Aberta

improves sdk consistency improves spec compliance P3 v2

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

modelcontextprotocol/python-sdk#2278 · 1 comentário · Aberta em 11/3/2026
pywin32 installation fails on Windows — hard dep only needed for client stdio, but pulled in for all users via eager import in __init__.py Aberta

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2233 · 3 comentários · Aberta em 6/3/2026
Bug: validate_scope rejects client scopes when required scopes in None Aberta

auth bug P2 ready for work

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

modelcontextprotocol/python-sdk#2216 · 5 comentários · Aberta em 5/3/2026
Type the MCPServer handler pipeline: tool/resource/prompt return types Aberta

enhancement v2

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

modelcontextprotocol/python-sdk#2202 · Aberta em 2/3/2026
MCPServer handlers should raise exceptions, not return error objects Aberta

enhancement v2

Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 35/100

modelcontextprotocol/python-sdk#2153 · Aberta em 27/2/2026
Active Streamable HTTP sessions are not terminated during shutdown Aberta

bug P2 ready for work

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

modelcontextprotocol/python-sdk#2150 · 3 comentários · Aberta em 26/2/2026
Add wildcard pattern support for `allowed_hosts` in transport security Aberta

enhancement needs confirmation

modelcontextprotocol/python-sdk#2141 · 1 comentário · 1 responsável · Aberta em 25/2/2026
Allow `OAuthClientProvider` to accept a pre-configured auth server URL Aberta

auth enhancement needs confirmation

modelcontextprotocol/python-sdk#2121 · 1 responsável · Aberta em 21/2/2026
Support MCP client session resumption (sessionId reuse) in Python SDK Aberta

enhancement P2 v2

Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 35/100

modelcontextprotocol/python-sdk#2116 · 2 comentários · 1 reação · Aberta em 20/2/2026
ExceptionGroup wrapping obscures real errors from task groups Aberta

bug P1 v2

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

modelcontextprotocol/python-sdk#2114 · 3 comentários · 2 reações · Aberta em 19/2/2026
HTTP transport swallows non-2xx status codes causing client to hang Aberta

bug P1 v2

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

modelcontextprotocol/python-sdk#2110 · 7 comentários · 2 reações · Aberta em 19/2/2026
Expose session, auth, and transport information on handler Context Aberta

enhancement P1 v2

Dificuldade 5/5 Mais de uma semana Facilidade para iniciantes 35/100

modelcontextprotocol/python-sdk#2098 · 1 comentário · Aberta em 19/2/2026

modelcontextprotocol/python-sdk

Receba novas issues na sua caixa de entrada