modelcontextprotocol/python-sdk

Ver en GitHub

The official Python SDK for Model Context Protocol servers and clients

Estrellas: 24.3k
Forks: 4k
Issues abiertos para principiantes: 17
Issues indexados: 241
Merge medio: 1 d 1 h
PR fusionados (30 d): 31

Lenguaje dominante: Python
Licencia: MIT
Último push a GitHub: 16/9/2026
Última indexación: 20/9/2026
Guía de contribución: Guía de contribución
Código de conducta: Código de conducta
Etiquetas para principiantes: good first issue help wanted

Para principiantes Todo

Abierto Todos

241 issues abiertos indexados

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

bug needs confirmation P2

Dificultad 4/5 3-5 días Aptitud para principiantes 47/100

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

bug needs confirmation P2

Dificultad 4/5 3-5 días Aptitud para principiantes 52/100

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

enhancement needs decision P3

Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100

modelcontextprotocol/python-sdk#2727 · 3 comentarios · Abierto el 30/5/2026
FastMCP: streamable_http_app() silently breaks when BaseHTTPMiddleware is added Abierto

bug needs repro P3 potentially close

Dificultad 3/5 1-2 días Aptitud para principiantes 64/100

modelcontextprotocol/python-sdk#2702 · 5 comentarios · Abierto el 27/5/2026
`ClientSessionGroup` attempts to use capabilities that were not advertised Abierto

bug fix proposed P2 ready for work

Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100

modelcontextprotocol/python-sdk#2689 · 3 comentarios · Abierto el 26/5/2026
`OAuthClientInformationFull.redirect_uris`: pydantic strict-type-equality breaks `AnyUrl(x) != AnyHttpUrl(x)` round-trip Abierto

auth bug fix proposed P2 ready for work

Dificultad 3/5 1-2 días Aptitud para principiantes 72/100

modelcontextprotocol/python-sdk#2687 · 3 comentarios · Abierto el 26/5/2026
FastMCP/stdio: in-flight tool responses dropped on stdin EOF when input is bash-redirected from a file Abierto

bug P2 ready for work

Dificultad 4/5 3-5 días Aptitud para principiantes 55/100

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

enhancement needs decision P3

Dificultad 3/5 1-2 días Aptitud para principiantes 68/100

modelcontextprotocol/python-sdk#2673 · 4 comentarios · Abierto el 24/5/2026
FastMCP.run(transport="stdio") produces noisy traceback on KeyboardInterrupt instead of clean exit Abierto

bug fix proposed P3 ready for work

Dificultad 3/5 1-2 días Aptitud para principiantes 64/100

modelcontextprotocol/python-sdk#2663 · 3 comentarios · Abierto el 22/5/2026
Streamable HTTP server silently drops in-flight request when client reuses a JSON-RPC id Abierto

bug fix proposed P2 ready for work

Dificultad 3/5 1-2 días Aptitud para principiantes 68/100

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

bug needs repro

Dificultad 4/5 3-5 días Aptitud para principiantes 42/100

modelcontextprotocol/python-sdk#2653 · 3 comentarios · Abierto el 21/5/2026
DCR registration accepts redirect_uris with non-HTTPS / non-loopback / fragmented schemes Abierto

auth bug fix proposed P2 ready for work

Dificultad 3/5 1-2 días Aptitud para principiantes 67/100

modelcontextprotocol/python-sdk#2629 · 1 comentario · Abierto el 18/5/2026
Add option to skip output validation for mcp client Abierto

enhancement needs decision P3

Dificultad 3/5 1-2 días Aptitud para principiantes 65/100

modelcontextprotocol/python-sdk#2626 · 3 comentarios · Abierto el 17/5/2026
RequestResponder.__exit__ leaks CancelledError on cancelled request, killing the stdio receive loop Abierto

bug needs confirmation P2 potentially close

Dificultad 3/5 1-2 días Aptitud para principiantes 68/100

modelcontextprotocol/python-sdk#2610 · 3 comentarios · Abierto el 15/5/2026
Duplicate `initialize` with changed parameters can overwrite `ServerSession.client_params` Abierto

bug fix proposed P2 ready for work

Dificultad 4/5 3-5 días Aptitud para principiantes 48/100

modelcontextprotocol/python-sdk#2605 · 4 comentarios · Abierto el 15/5/2026
`ClientConfig` has inconsistent naming: `message_handler` should be `message_callback` Abierto

enhancement needs decision P3 v2

Dificultad 3/5 1-2 días Aptitud para principiantes 73/100

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

enhancement needs decision P3

Dificultad 3/5 1-2 días Aptitud para principiantes 55/100

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

auth bug fix proposed P2 ready for work

Dificultad 4/5 3-5 días Aptitud para principiantes 55/100

modelcontextprotocol/python-sdk#2578 · 6 comentarios · Abierto el 12/5/2026
raise without from discards exception chain in 12 remaining sites Abierto

bug P3

Dificultad 3/5 1-2 días Aptitud para principiantes 74/100

modelcontextprotocol/python-sdk#2564 · 3 comentarios · Abierto el 8/5/2026
Add `list_all_*` helpers to drain pagination Abierto

enhancement P3 v2

Dificultad 3/5 1-2 días Aptitud para principiantes 52/100

modelcontextprotocol/python-sdk#2556 · 3 comentarios · Abierto el 8/5/2026
Split the core from the server and client implementations Abierto

enhancement needs decision P3 v2

Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100

modelcontextprotocol/python-sdk#2486 · 4 comentarios · Abierto el 21/4/2026
Return 405 on GET when stateless_http=True Abierto

bug P2

Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100

modelcontextprotocol/python-sdk#2474 · 4 comentarios · 2 reacciones · Abierto el 19/4/2026
MCPServer unconditionally declares `prompts`, `resources`, `tools` capabilities on `initialize` Abierto

bug P2

Dificultad 4/5 3-5 días Aptitud para principiantes 45/100

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

bug fix proposed P2 ready for work

Dificultad 3/5 1-2 días Aptitud para principiantes 78/100

modelcontextprotocol/python-sdk#2454 · 3 comentarios · Abierto el 16/4/2026
Windows: TextIOWrapper in stdio_server() emits CRLF instead of LF, corrupting newline-delimited JSON messages Abierto

bug fix proposed P2 ready for work

Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100

modelcontextprotocol/python-sdk#2433 · 9 comentarios · Abierto el 13/4/2026
Initialize call hangs forever if MCP server does not return a `Content-Type: text/plain` Abierto

bug fix proposed P2 ready for work

Dificultad 3/5 1-2 días Aptitud para principiantes 58/100

modelcontextprotocol/python-sdk#2432 · 3 comentarios · Abierto el 13/4/2026
McpError is not pickle-safe and fails to unpickle Abierto

bug fix proposed P2 ready for work

Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100

modelcontextprotocol/python-sdk#2431 · 9 comentarios · Abierto el 13/4/2026
[v1.x] Server-side outputSchema validation blocks tool error reporting (isError: true) Abierto

bug fix proposed P2 ready for work

Dificultad 3/5 1-2 días Aptitud para principiantes 70/100

modelcontextprotocol/python-sdk#2429 · 2 comentarios · Abierto el 13/4/2026
Specific ToolNotFoundError for easier handling than ToolError in multi-tenant environments Abierto

enhancement needs decision P3

Dificultad 3/5 1-2 días Aptitud para principiantes 50/100

modelcontextprotocol/python-sdk#2422 · 4 comentarios · Abierto el 10/4/2026
Bug: AssertionError: Request already responded to — cancellation race in v1.27.0 Abierto

bug fix proposed P2 ready for work

Dificultad 4/5 3-5 días Aptitud para principiantes 68/100

modelcontextprotocol/python-sdk#2416 · 14 comentarios · Abierto el 9/4/2026
StreamableHTTP client: _handle_reconnection resets attempt counter to 0, causing infinite retry loop Abierto

bug P2

Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100

modelcontextprotocol/python-sdk#2393 · 2 comentarios · Abierto el 5/4/2026
Inline $ref in tool inputSchema for LLM consumption (parity with typescript-sdk) Abierto

enhancement needs decision P2

Dificultad 3/5 1-2 días Aptitud para principiantes 68/100

modelcontextprotocol/python-sdk#2384 · 2 comentarios · Abierto el 2/4/2026
ClientSession: add public API for updating callbacks after initialization Abierto

enhancement needs decision P3

Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100

modelcontextprotocol/python-sdk#2379 · 4 comentarios · Abierto el 30/3/2026
Image/ImageContent serialization fails in stateless HTTP mode Abierto

bug needs confirmation P2

Dificultad 3/5 1-2 días Aptitud para principiantes 55/100

modelcontextprotocol/python-sdk#2376 · 3 comentarios · 5 reacciones · Abierto el 29/3/2026
Design: future of `dependencies` parameter on MCPServer Abierto

enhancement needs decision P2 v2

Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100

modelcontextprotocol/python-sdk#2354 · 2 comentarios · 4 reacciones · Abierto el 26/3/2026
Add remove_prompt() and remove_resource() for parity with remove_tool() Abierto

enhancement needs decision P3

Dificultad 3/5 1-2 días Aptitud para principiantes 72/100

modelcontextprotocol/python-sdk#2331 · 4 comentarios · Abierto el 22/3/2026
Improve log clarity for "Terminating session: None" in stateless mode Abierto

enhancement P3

Dificultad 2/5 1-3 horas Aptitud para principiantes 45/100

modelcontextprotocol/python-sdk#2329 · 1 comentario · Abierto el 22/3/2026
Don't override client_metadata.scopes if they are already set Abierto

auth enhancement needs decision P2

Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100

modelcontextprotocol/python-sdk#2317 · 5 comentarios · Abierto el 20/3/2026
Mark SSE transport as deprecated Abierto

improves sdk consistency improves spec compliance P3 v2

Dificultad 3/5 1-2 días Aptitud para principiantes 68/100

modelcontextprotocol/python-sdk#2278 · 1 comentario · Abierto el 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 Abierto

enhancement needs decision P2

Dificultad 3/5 1-2 días Aptitud para principiantes 76/100

modelcontextprotocol/python-sdk#2233 · 3 comentarios · Abierto el 6/3/2026
Bug: validate_scope rejects client scopes when required scopes in None Abierto

auth bug P2 ready for work

Dificultad 2/5 1-3 horas Aptitud para principiantes 64/100

modelcontextprotocol/python-sdk#2216 · 5 comentarios · Abierto el 5/3/2026
Type the MCPServer handler pipeline: tool/resource/prompt return types Abierto

enhancement v2

Dificultad 4/5 3-5 días Aptitud para principiantes 48/100

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

enhancement v2

Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100

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

bug P2 ready for work

Dificultad 4/5 3-5 días Aptitud para principiantes 48/100

modelcontextprotocol/python-sdk#2150 · 3 comentarios · Abierto el 26/2/2026
Add wildcard pattern support for `allowed_hosts` in transport security Abierto

enhancement needs confirmation

modelcontextprotocol/python-sdk#2141 · 1 comentario · 1 asignado · Abierto el 25/2/2026
Allow `OAuthClientProvider` to accept a pre-configured auth server URL Abierto

auth enhancement needs confirmation

modelcontextprotocol/python-sdk#2121 · 1 asignado · Abierto el 21/2/2026
Support MCP client session resumption (sessionId reuse) in Python SDK Abierto

enhancement P2 v2

Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100

modelcontextprotocol/python-sdk#2116 · 2 comentarios · 1 reacción · Abierto el 20/2/2026
ExceptionGroup wrapping obscures real errors from task groups Abierto

bug P1 v2

Dificultad 4/5 3-5 días Aptitud para principiantes 48/100

modelcontextprotocol/python-sdk#2114 · 3 comentarios · 2 reacciones · Abierto el 19/2/2026
HTTP transport swallows non-2xx status codes causing client to hang Abierto

bug P1 v2

Dificultad 4/5 3-5 días Aptitud para principiantes 48/100

modelcontextprotocol/python-sdk#2110 · 7 comentarios · 2 reacciones · Abierto el 19/2/2026
Expose session, auth, and transport information on handler Context Abierto

enhancement P1 v2

Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100

modelcontextprotocol/python-sdk#2098 · 1 comentario · Abierto el 19/2/2026

modelcontextprotocol/python-sdk

Recibe los nuevos issues en tu correo