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

Requests with "id": null silently misclassified as notifications Abierto

bug improves spec compliance P2

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

modelcontextprotocol/python-sdk#2057 · 10 comentarios · 1 reacción · Abierto el 14/2/2026
Replace Field(description=...) with proper docstrings in auth models Abierto

auth enhancement v2

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

modelcontextprotocol/python-sdk#2053 · 1 comentario · Abierto el 13/2/2026
Audit MCPServer constructor parameters Abierto

enhancement v2

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

modelcontextprotocol/python-sdk#2052 · 1 comentario · Abierto el 13/2/2026
Refactor handler context to be transport- and handler-type-aware Abierto

P1 v2

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

modelcontextprotocol/python-sdk#2021 · 1 comentario · Abierto el 9/2/2026
find_context_parameter() fails to detect Context parameter in callable class instances Abierto

bug P3 v2

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

modelcontextprotocol/python-sdk#1974 · 1 comentario · Abierto el 30/1/2026
Per-Request Transport Configuration for MCP Clients Abierto

documentation enhancement v2

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

modelcontextprotocol/python-sdk#1966 · 2 comentarios · 1 reacción · Abierto el 27/1/2026
Using transport="stdio" closes real stdio, causing ValueError after server exits Abierto

bug good first issue P3

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

modelcontextprotocol/python-sdk#1933 · 8 comentarios · Abierto el 22/1/2026
Trailing slash in OAuthMetadata's `issuer` causes issues with clients Abierto

auth bug P1 ready for work

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

modelcontextprotocol/python-sdk#1919 · 5 comentarios · 1 reacción · Abierto el 21/1/2026
Bug: String parameters starting with digits coerced to numbers, causing UUID data loss Abierto

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1873 · 4 comentarios · Abierto el 15/1/2026
ClientAuthenticator ignores token_endpoint_auth_method="none" when client_secret is stored Abierto

auth bug needs confirmation needs decision P2

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

modelcontextprotocol/python-sdk#1842 · 6 comentarios · Abierto el 8/1/2026
Clarify JSON-RPC error code for 'session not found' responses Abierto

enhancement improves spec compliance needs decision P2 pending SEP approval v2

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

modelcontextprotocol/python-sdk#1821 · Abierto el 31/12/2025
client's `read_stream_writer` open after SSE disconnection hanging `.receive()` Abierto

bug P1 ready for work

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

modelcontextprotocol/python-sdk#1811 · 3 comentarios · Abierto el 21/12/2025
More control over stderr in stdio client Abierto

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#1806 · 1 comentario · Abierto el 19/12/2025
Possible ressource leak / race condition in streamable_http_client Abierto

bug needs confirmation

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

modelcontextprotocol/python-sdk#1805 · 10 comentarios · 2 reacciones · Abierto el 19/12/2025
Implement server-side support for Client ID Metadata Documents (CIMD) Abierto

auth enhancement needs decision P2

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

modelcontextprotocol/python-sdk#1801 · 3 comentarios · Abierto el 18/12/2025
Make JSON-RPC ID type coercion configurable Abierto

bug P3 v2

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

modelcontextprotocol/python-sdk#1795 · 2 comentarios · Abierto el 17/12/2025
Remove jsonschema dependency Abierto

enhancement P3 v2

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

modelcontextprotocol/python-sdk#1745 · 1 comentario · Abierto el 5/12/2025
Improve exception tracebacks for easier debugging Abierto

enhancement P2 v2

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

modelcontextprotocol/python-sdk#1744 · 1 comentario · Abierto el 5/12/2025
Extract OAuth flow logic into reusable components for proxy use cases Abierto

auth enhancement P1 v2

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

modelcontextprotocol/python-sdk#1743 · 9 comentarios · 2 reacciones · Abierto el 5/12/2025
Introduce typed error classes with metadata Abierto

breaking change enhancement P2 v2

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

modelcontextprotocol/python-sdk#1742 · 1 comentario · 3 reacciones · Abierto el 5/12/2025
Support clean server shutdown Abierto

enhancement P1 v2

modelcontextprotocol/python-sdk#1739 · 1 comentario · 2 reacciones · 1 asignado · Abierto el 5/12/2025
Audit and document the MCP server publishing experience Abierto

enhancement P2 v2

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

modelcontextprotocol/python-sdk#1734 · 1 comentario · Abierto el 5/12/2025
`auth` specification in `ClientSessionGroup` Abierto

auth enhancement help wanted needs decision P2

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

modelcontextprotocol/python-sdk#1723 · 4 comentarios · 1 reacción · Abierto el 4/12/2025
Document and provide hooks for sandboxing file and network access in MCP tools Abierto

documentation enhancement needs confirmation

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

modelcontextprotocol/python-sdk#1705 · 28 comentarios · Abierto el 28/11/2025
Define and document the public Python SDK API surface Abierto

breaking change enhancement P1 ready for work v2

modelcontextprotocol/python-sdk#1701 · 4 comentarios · 2 reacciones · 1 asignado · Abierto el 28/11/2025
Refactor func_metadata() into smaller components for schema & metadata generation Abierto

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#1700 · 1 comentario · Abierto el 28/11/2025
Simplify and harden session lifecycle with an explicit state machine Abierto

enhancement P2 v2

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

modelcontextprotocol/python-sdk#1691 · 2 comentarios · Abierto el 28/11/2025
MCP client doesn't not initialize new session when getting 404 session not found Abierto

bug improves spec compliance P2 ready for work

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

modelcontextprotocol/python-sdk#1676 · 4 comentarios · Abierto el 26/11/2025
Streamable HTTP transport drops requests immediately after `initialize` Abierto

bug P1 ready for work

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

modelcontextprotocol/python-sdk#1675 · 1 comentario · 2 reacciones · Abierto el 26/11/2025
ServerSession methods (create_message, elicit_form) don't expose progress_callback parameter Abierto

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#1671 · 2 comentarios · Abierto el 25/11/2025
User-Agent header in sHTTP transport is not forwarded to auth flow Abierto

auth bug P2 ready for work

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

modelcontextprotocol/python-sdk#1664 · 5 comentarios · 1 reacción · Abierto el 25/11/2025
FastMCP configures logging on init, which messes up application-level logging Abierto

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1656 · 7 comentarios · 6 reacciones · Abierto el 24/11/2025
ClientDisconnect returns HTTP 500 Abierto

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1648 · 6 comentarios · 1 reacción · Abierto el 20/11/2025
OAuth: 403 responses without insufficient_scope incorrectly retry with same token Abierto

auth P3

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

modelcontextprotocol/python-sdk#1602 · Abierto el 10/11/2025
Client tool call hangs forever if server crashes or connection dies when using streamable-http Abierto

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1577 · 3 comentarios · 2 reacciones · Abierto el 5/11/2025
OAuthClientProvider._handle_token_response expect json Abierto

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1523 · 1 reacción · Abierto el 28/10/2025
FastMCP: Support dynamic annotation updates Abierto

enhancement improves spec compliance P2

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

modelcontextprotocol/python-sdk#1475 · 2 comentarios · 1 reacción · Abierto el 13/10/2025
Improve docs on how to use `instructions` on `InitializeResult` Abierto

documentation P1 ready for work

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

modelcontextprotocol/python-sdk#1464 · 4 comentarios · 1 reacción · Abierto el 10/10/2025
Response leak in SSE handlers Abierto

needs repro P2 ready for work

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

modelcontextprotocol/python-sdk#1450 · 3 comentarios · Abierto el 9/10/2025
feat: enhance dynamic tool management with notifications and enable/disable Abierto

enhancement needs decision P1 v2

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

modelcontextprotocol/python-sdk#1429 · 4 comentarios · 2 reacciones · Abierto el 6/10/2025
It is not possible to define a Resource that takes only the Context parameter as an argument. Abierto

bug improves spec compliance P2 ready for work

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

modelcontextprotocol/python-sdk#1405 · 2 comentarios · Abierto el 26/9/2025
ClientSession Error Handling Abierto

bug good first issue P1 ready for work

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

modelcontextprotocol/python-sdk#1401 · 22 comentarios · 7 reacciones · Abierto el 25/9/2025
Lazy HTTP connections seem to make error handling difficult. Abierto

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#1393 · Abierto el 24/9/2025
No default timeout for requests (unlike TS SDK) Abierto

enhancement improves sdk consistency needs decision P2

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

modelcontextprotocol/python-sdk#1374 · 4 comentarios · Abierto el 17/9/2025
Using /.well-known/ OAuth endpoints behind custom path on GKE Abierto

auth enhancement good first issue needs decision P2 question

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

modelcontextprotocol/python-sdk#1335 · 4 comentarios · Abierto el 2/9/2025
`stdio_server` uses unbuffered memory streams which can cause server to block and become unresponsive Abierto

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1333 · 1 comentario · 1 reacción · Abierto el 1/9/2025
Implement consistent structuredContent handling per specification clarification Abierto

bug enhancement needs decision P3 pending SEP approval

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

modelcontextprotocol/python-sdk#1332 · 1 comentario · Abierto el 1/9/2025
Clients Using Storage Face Deadlock on Token Refresh for SSE Abierto

bug P2 ready for work

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

modelcontextprotocol/python-sdk#1326 · 4 comentarios · Abierto el 30/8/2025
Support selection of authorization servers from PRM document Abierto

auth enhancement

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

modelcontextprotocol/python-sdk#1319 · Abierto el 28/8/2025
Critical Token Refresh Bugs - Prevents Proactive Refresh Abierto

auth P1 ready for work

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

modelcontextprotocol/python-sdk#1318 · 9 comentarios · 6 reacciones · Abierto el 28/8/2025

modelcontextprotocol/python-sdk

Recibe los nuevos issues en tu correo