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

Windows MCP SSH stdio transport closes after initialize when PROGRAMDATA is missing from inherited environment Abierto

v1 v2

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

modelcontextprotocol/python-sdk#3335 · 1 comentario · Abierto el 19/8/2026
Add add_resource_template() to MCPServer Abierto

v2

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

modelcontextprotocol/python-sdk#3333 · 1 comentario · Abierto el 19/8/2026
[v2] Expose the SSE max_event_size setting in Streamable HTTP clients Abierto

v2

modelcontextprotocol/python-sdk#3332 · 7 comentarios · 1 asignado · Abierto el 18/8/2026
streamable-http client: no size bound before JSONRPCMessage.model_validate_json — one large server message can OOM the client Abierto

v1 v2

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

modelcontextprotocol/python-sdk#3330 · 2 comentarios · Abierto el 18/8/2026
docs: no guidance for supporting SDK 1.x and 2.x at the same time Abierto

v2

Dificultad 2/5 Medio día Aptitud para principiantes 62/100

modelcontextprotocol/python-sdk#3309 · 10 comentarios · Abierto el 14/8/2026
Streamable HTTP clean EOF reconnects can exceed the request retry budget Abierto

bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3307 · 5 comentarios · Abierto el 14/8/2026
A tool returning an empty list produces a CallToolResult with zero content blocks Abierto

enhancement needs decision P2 v1 v2

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

modelcontextprotocol/python-sdk#3305 · 1 comentario · Abierto el 13/8/2026
check_resource_allowed(): path matching skips dot-segment/percent-encoding normalization (auth-boundary bypass) Abierto

auth bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3303 · 4 comentarios · Abierto el 13/8/2026
find_context_parameter treats a Context return annotation as a parameter Abierto

P3 v1 v2

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

modelcontextprotocol/python-sdk#3298 · 5 comentarios · Abierto el 12/8/2026
resource_url_from_server_url preserves explicit default ports Abierto

P3 v1 v2

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

modelcontextprotocol/python-sdk#3297 · 1 comentario · Abierto el 12/8/2026
docs: clarify when Client(raise_exceptions=True) actually raises Abierto

P3 v1 v2

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

modelcontextprotocol/python-sdk#3287 · 1 comentario · Abierto el 11/8/2026
Authentication in High Level MCPServer Abierto

P3 question v1 v2

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

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

bug P2 v1 v2

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

modelcontextprotocol/python-sdk#3281 · 1 comentario · Abierto el 11/8/2026
New example: examples/servers/admission-gate — a real approve/deny ServerMiddleware demo Abierto

documentation P3 v2

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

modelcontextprotocol/python-sdk#3272 · 4 comentarios · Abierto el 8/8/2026
Mcp-Name accepts an orphan header, while Mcp-Param-* rejects it as a routing spoof Abierto

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

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

modelcontextprotocol/python-sdk#3269 · 1 comentario · Abierto el 8/8/2026
`handle_get_stream` reconnects indefinitely when the server ends the GET stream normally (`attempt = 0` defeats `MAX_RECONNECTION_ATTEMPTS`) Abierto

P2 v1 v2

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

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

bug P1 v1 v2

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

modelcontextprotocol/python-sdk#3256 · 1 comentario · Abierto el 5/8/2026
[v2] MCPServer reports empty experimental capabilities as {} via initialize but None via server/discover Abierto

P2 spec-2026-07-28 v2

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

modelcontextprotocol/python-sdk#3254 · 1 comentario · Abierto el 5/8/2026
OAuthClientProvider._initialize() breaks transparent refresh: missing update_token_expiry + missing oauth_metadata load Abierto

P1 v1 v2

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

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

P1 v1 v2

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

modelcontextprotocol/python-sdk#3240 · 2 comentarios · Abierto el 3/8/2026
Expose create_mcp_http_client and McpHttpClientFactory as public API (2.0 made them private-only) Abierto

P1 v2

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

modelcontextprotocol/python-sdk#3238 · 4 comentarios · Abierto el 3/8/2026
Parameterized Context loses request state in resource and prompt handlers Abierto

P1 v2

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

modelcontextprotocol/python-sdk#3235 · 2 comentarios · Abierto el 1/8/2026
Client-side support for the tasks extension (io.modelcontextprotocol/tasks, SEP-2663) Abierto

P2 spec-2026-07-28 v2

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

modelcontextprotocol/python-sdk#3226 · 3 comentarios · Abierto el 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 Abierto

P2 v1 v2

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

modelcontextprotocol/python-sdk#3209 · 1 comentario · Abierto el 29/7/2026
[v2] JSON-RPC error responses leave client OpenTelemetry spans UNSET Abierto

bug needs confirmation P2 v2

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

modelcontextprotocol/python-sdk#3174 · 9 comentarios · Abierto el 26/7/2026
Fix Streamable HTTP Accept header quality-factor handling Abierto

bug needs confirmation P3 v1 v2

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

modelcontextprotocol/python-sdk#3154 · 1 comentario · Abierto el 23/7/2026
Deeply-nested-body test fails on macOS: rejected as INVALID_REQUEST (-32600) instead of PARSE_ERROR (-32700) Abierto

bug P3 spec-2026-07-28 v2

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

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

enhancement needs decision P3 v1 v2

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

modelcontextprotocol/python-sdk#3145 · 3 comentarios · Abierto el 22/7/2026
OAuth client sends client_id in token body under client_secret_basic (strict servers reject as multiple auth methods) Abierto

auth bug needs confirmation P1 v1 v2

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

modelcontextprotocol/python-sdk#3138 · 6 comentarios · Abierto el 21/7/2026
perf: JSONRPCMessage smart union scores all four branches on every inbound message Abierto

enhancement needs decision P3 v1 v2

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

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

bug needs confirmation P2 v2

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

modelcontextprotocol/python-sdk#3126 · 2 comentarios · Abierto el 18/7/2026
RequireAuthMiddleware omits RFC 6750 scope in WWW-Authenticate on 401/403 Abierto

auth bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3103 · 2 comentarios · 4 reacciones · Abierto el 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 Abierto

bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3102 · 5 comentarios · Abierto el 16/7/2026
Generated output schema uses Pydantic's validation shape while structured output uses its serialization shape Abierto

bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3100 · 2 comentarios · Abierto el 16/7/2026
Field alias is published in the tool schema but forwarded as an invalid Python keyword Abierto

bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3099 · 7 comentarios · Abierto el 16/7/2026
Heavy sync init work (e.g. local ML models) starves stdio initialize/tool calls even with threadpool offload -- Windows GIL contention Abierto

documentation enhancement needs decision P3 v1 v2

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

modelcontextprotocol/python-sdk#3089 · 3 comentarios · Abierto el 12/7/2026
FastMCP tool argument models silently ignore unknown/misspelled arguments (extra=ignore default) Abierto

enhancement needs decision P2 v1 v2

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

modelcontextprotocol/python-sdk#3067 · 1 comentario · 1 reacción · Abierto el 6/7/2026
[v2] RFC 9728 PRM URLs and resource matching drop query components Abierto

auth bug needs confirmation P2 v1 v2

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

modelcontextprotocol/python-sdk#3065 · 2 comentarios · Abierto el 6/7/2026
streamable HTTP (stateful): concurrent requests with duplicate JSON-RPC ids cross-wire responses — one request receives another's payload, the other hangs Abierto

bug P2 v1 v2

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

modelcontextprotocol/python-sdk#3060 · 5 comentarios · 1 reacción · Abierto el 3/7/2026
FuncMetadata.pre_parse_json mis-detects str | None as non-string and corrupts JSON-looking string arguments Abierto

bug P2 v1 v2

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

modelcontextprotocol/python-sdk#3055 · 2 comentarios · Abierto el 2/7/2026
WWW-Authenticate parsing matches a field name as a substring of another auth-param Abierto

auth bug P2 v2

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

modelcontextprotocol/python-sdk#3009 · 2 comentarios · Abierto el 27/6/2026
[Bug] check_capability does not validate elicitation sub-capabilities (form/url) Abierto

bug needs confirmation P2 v2

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

modelcontextprotocol/python-sdk#2965 · 2 comentarios · Abierto el 25/6/2026
StreamableHTTP server accumulates CLOSE_WAIT sockets behind reverse proxy due to missing disconnect cleanup Abierto

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2958 · 1 comentario · Abierto el 24/6/2026
dict[str, T] tool return types lose Annotated/Field metadata in output schema Abierto

bug P3 v2

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

modelcontextprotocol/python-sdk#2935 · 2 comentarios · Abierto el 20/6/2026
Capabilities API + server/discover handler Abierto

enhancement P2 spec-2026-07-28 v2

modelcontextprotocol/python-sdk#2896 · 1 asignado · Abierto el 17/6/2026
Invalid JSON-RPC envelope errors are not correlated with the original request id Abierto

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2848 · 1 comentario · Abierto el 12/6/2026
Bug: anyio.Lock in async_auth_flow causes RuntimeError under concurrent OAuth MCP connections Abierto

auth bug needs confirmation P1

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

modelcontextprotocol/python-sdk#2847 · 5 comentarios · Abierto el 12/6/2026
`simple-auth` is not working as expected Abierto

auth bug P2

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

modelcontextprotocol/python-sdk#2826 · Abierto el 10/6/2026
Implement SEP-2663: Tasks Extension Abierto

enhancement

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

modelcontextprotocol/python-sdk#2806 · 9 comentarios · 7 reacciones · Abierto el 6/6/2026
OAuth handler doesn't support redirect URLs with params Abierto

auth bug P2

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

modelcontextprotocol/python-sdk#2776 · 2 comentarios · Abierto el 3/6/2026

modelcontextprotocol/python-sdk

Recibe los nuevos issues en tu correo