modelcontextprotocol/python-sdk

Voir sur GitHub

The official Python SDK for Model Context Protocol servers and clients

Étoiles: 24.3k
Forks: 4k
Issues débutants ouvertes: 17
Issues indexées: 241
Merge moyen: 1 j 1 h
PR mergées (30 j): 31

Langage dominant: Python
Licence: MIT
Dernier push GitHub: 16/9/2026
Dernière indexation: 20/9/2026
Guide de contribution: Guide de contribution
Code de conduite: Code de conduite
Labels débutants: good first issue help wanted

Accessible aux débutants Tout

Ouverte Toutes

241 issues ouvertes indexées

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

bug improves spec compliance P2

Difficulté 3/5 1-2 jours Accessibilité débutants 48/100

modelcontextprotocol/python-sdk#2057 · 10 commentaires · 1 réaction · Ouverte le 14/2/2026
Replace Field(description=...) with proper docstrings in auth models Ouverte

auth enhancement v2

Difficulté 3/5 1-2 jours Accessibilité débutants 52/100

modelcontextprotocol/python-sdk#2053 · 1 commentaire · Ouverte le 13/2/2026
Audit MCPServer constructor parameters Ouverte

enhancement v2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100

modelcontextprotocol/python-sdk#2052 · 1 commentaire · Ouverte le 13/2/2026
Refactor handler context to be transport- and handler-type-aware Ouverte

P1 v2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

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

bug P3 v2

Difficulté 2/5 1-3 heures Accessibilité débutants 55/100

modelcontextprotocol/python-sdk#1974 · 1 commentaire · Ouverte le 30/1/2026
Per-Request Transport Configuration for MCP Clients Ouverte

documentation enhancement v2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 38/100

modelcontextprotocol/python-sdk#1966 · 2 commentaires · 1 réaction · Ouverte le 27/1/2026
Using transport="stdio" closes real stdio, causing ValueError after server exits Ouverte

bug good first issue P3

Difficulté 2/5 1-3 heures Accessibilité débutants 68/100

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

auth bug P1 ready for work

Difficulté 3/5 1-2 jours Accessibilité débutants 58/100

modelcontextprotocol/python-sdk#1919 · 5 commentaires · 1 réaction · Ouverte le 21/1/2026
Bug: String parameters starting with digits coerced to numbers, causing UUID data loss Ouverte

bug P2 ready for work

Difficulté 3/5 1-2 jours Accessibilité débutants 65/100

modelcontextprotocol/python-sdk#1873 · 4 commentaires · Ouverte le 15/1/2026
ClientAuthenticator ignores token_endpoint_auth_method="none" when client_secret is stored Ouverte

auth bug needs confirmation needs decision P2

Difficulté 2/5 1-3 heures Accessibilité débutants 72/100

modelcontextprotocol/python-sdk#1842 · 6 commentaires · Ouverte le 8/1/2026
Clarify JSON-RPC error code for 'session not found' responses Ouverte

enhancement improves spec compliance needs decision P2 pending SEP approval v2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

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

bug P1 ready for work

Difficulté 3/5 1-2 jours Accessibilité débutants 42/100

modelcontextprotocol/python-sdk#1811 · 3 commentaires · Ouverte le 21/12/2025
More control over stderr in stdio client Ouverte

enhancement needs decision P3

Difficulté 2/5 1-3 heures Accessibilité débutants 68/100

modelcontextprotocol/python-sdk#1806 · 1 commentaire · Ouverte le 19/12/2025
Possible ressource leak / race condition in streamable_http_client Ouverte

bug needs confirmation

Difficulté 4/5 3-5 jours Accessibilité débutants 45/100

modelcontextprotocol/python-sdk#1805 · 10 commentaires · 2 réactions · Ouverte le 19/12/2025
Implement server-side support for Client ID Metadata Documents (CIMD) Ouverte

auth enhancement needs decision P2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100

modelcontextprotocol/python-sdk#1801 · 3 commentaires · Ouverte le 18/12/2025
Make JSON-RPC ID type coercion configurable Ouverte

bug P3 v2

Difficulté 4/5 3-5 jours Accessibilité débutants 45/100

modelcontextprotocol/python-sdk#1795 · 2 commentaires · Ouverte le 17/12/2025
Remove jsonschema dependency Ouverte

enhancement P3 v2

Difficulté 3/5 1-2 jours Accessibilité débutants 48/100

modelcontextprotocol/python-sdk#1745 · 1 commentaire · Ouverte le 5/12/2025
Improve exception tracebacks for easier debugging Ouverte

enhancement P2 v2

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

modelcontextprotocol/python-sdk#1744 · 1 commentaire · Ouverte le 5/12/2025
Extract OAuth flow logic into reusable components for proxy use cases Ouverte

auth enhancement P1 v2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

modelcontextprotocol/python-sdk#1743 · 9 commentaires · 2 réactions · Ouverte le 5/12/2025
Introduce typed error classes with metadata Ouverte

breaking change enhancement P2 v2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100

modelcontextprotocol/python-sdk#1742 · 1 commentaire · 3 réactions · Ouverte le 5/12/2025
Support clean server shutdown Ouverte

enhancement P1 v2

modelcontextprotocol/python-sdk#1739 · 1 commentaire · 2 réactions · 1 personne assignée · Ouverte le 5/12/2025
Audit and document the MCP server publishing experience Ouverte

enhancement P2 v2

Difficulté 4/5 3-5 jours Accessibilité débutants 45/100

modelcontextprotocol/python-sdk#1734 · 1 commentaire · Ouverte le 5/12/2025
`auth` specification in `ClientSessionGroup` Ouverte

auth enhancement help wanted needs decision P2

Difficulté 3/5 1-2 jours Accessibilité débutants 68/100

modelcontextprotocol/python-sdk#1723 · 4 commentaires · 1 réaction · Ouverte le 4/12/2025
Document and provide hooks for sandboxing file and network access in MCP tools Ouverte

documentation enhancement needs confirmation

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100

modelcontextprotocol/python-sdk#1705 · 28 commentaires · Ouverte le 28/11/2025
Define and document the public Python SDK API surface Ouverte

breaking change enhancement P1 ready for work v2

modelcontextprotocol/python-sdk#1701 · 4 commentaires · 2 réactions · 1 personne assignée · Ouverte le 28/11/2025
Refactor func_metadata() into smaller components for schema & metadata generation Ouverte

enhancement needs decision P3

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 42/100

modelcontextprotocol/python-sdk#1700 · 1 commentaire · Ouverte le 28/11/2025
Simplify and harden session lifecycle with an explicit state machine Ouverte

enhancement P2 v2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

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

bug improves spec compliance P2 ready for work

Difficulté 3/5 1-2 jours Accessibilité débutants 70/100

modelcontextprotocol/python-sdk#1676 · 4 commentaires · Ouverte le 26/11/2025
Streamable HTTP transport drops requests immediately after `initialize` Ouverte

bug P1 ready for work

Difficulté 2/5 1-3 heures Accessibilité débutants 25/100

modelcontextprotocol/python-sdk#1675 · 1 commentaire · 2 réactions · Ouverte le 26/11/2025
ServerSession methods (create_message, elicit_form) don't expose progress_callback parameter Ouverte

enhancement needs decision P2

Difficulté 2/5 1-3 heures Accessibilité débutants 72/100

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

auth bug P2 ready for work

Difficulté 3/5 1-2 jours Accessibilité débutants 68/100

modelcontextprotocol/python-sdk#1664 · 5 commentaires · 1 réaction · Ouverte le 25/11/2025
FastMCP configures logging on init, which messes up application-level logging Ouverte

bug P2 ready for work

Difficulté 4/5 3-5 jours Accessibilité débutants 45/100

modelcontextprotocol/python-sdk#1656 · 7 commentaires · 6 réactions · Ouverte le 24/11/2025
ClientDisconnect returns HTTP 500 Ouverte

bug P2 ready for work

Difficulté 2/5 1-3 heures Accessibilité débutants 76/100

modelcontextprotocol/python-sdk#1648 · 6 commentaires · 1 réaction · Ouverte le 20/11/2025
OAuth: 403 responses without insufficient_scope incorrectly retry with same token Ouverte

auth P3

Difficulté 2/5 1-3 heures Accessibilité débutants 55/100

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

bug P2 ready for work

Difficulté 3/5 1-2 jours Accessibilité débutants 55/100

modelcontextprotocol/python-sdk#1577 · 3 commentaires · 2 réactions · Ouverte le 5/11/2025
OAuthClientProvider._handle_token_response expect json Ouverte

bug P2 ready for work

Difficulté 2/5 1-3 heures Accessibilité débutants 58/100

modelcontextprotocol/python-sdk#1523 · 1 réaction · Ouverte le 28/10/2025
FastMCP: Support dynamic annotation updates Ouverte

enhancement improves spec compliance P2

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100

modelcontextprotocol/python-sdk#1475 · 2 commentaires · 1 réaction · Ouverte le 13/10/2025
Improve docs on how to use `instructions` on `InitializeResult` Ouverte

documentation P1 ready for work

Difficulté 2/5 1-3 heures Accessibilité débutants 68/100

modelcontextprotocol/python-sdk#1464 · 4 commentaires · 1 réaction · Ouverte le 10/10/2025
Response leak in SSE handlers Ouverte

needs repro P2 ready for work

Difficulté 2/5 1-3 heures Accessibilité débutants 58/100

modelcontextprotocol/python-sdk#1450 · 3 commentaires · Ouverte le 9/10/2025
feat: enhance dynamic tool management with notifications and enable/disable Ouverte

enhancement needs decision P1 v2

Difficulté 4/5 3-5 jours Accessibilité débutants 38/100

modelcontextprotocol/python-sdk#1429 · 4 commentaires · 2 réactions · Ouverte le 6/10/2025
It is not possible to define a Resource that takes only the Context parameter as an argument. Ouverte

bug improves spec compliance P2 ready for work

Difficulté 3/5 1-2 jours Accessibilité débutants 42/100

modelcontextprotocol/python-sdk#1405 · 2 commentaires · Ouverte le 26/9/2025
ClientSession Error Handling Ouverte

bug good first issue P1 ready for work

Difficulté 4/5 3-5 jours Accessibilité débutants 45/100

modelcontextprotocol/python-sdk#1401 · 22 commentaires · 7 réactions · Ouverte le 25/9/2025
Lazy HTTP connections seem to make error handling difficult. Ouverte

enhancement needs decision P2

Difficulté 4/5 3-5 jours Accessibilité débutants 30/100

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

enhancement improves sdk consistency needs decision P2

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

modelcontextprotocol/python-sdk#1374 · 4 commentaires · Ouverte le 17/9/2025
Using /.well-known/ OAuth endpoints behind custom path on GKE Ouverte

auth enhancement good first issue needs decision P2 question

Difficulté 4/5 3-5 jours Accessibilité débutants 45/100

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

bug P2 ready for work

Difficulté 2/5 1-3 heures Accessibilité débutants 52/100

modelcontextprotocol/python-sdk#1333 · 1 commentaire · 1 réaction · Ouverte le 1/9/2025
Implement consistent structuredContent handling per specification clarification Ouverte

bug enhancement needs decision P3 pending SEP approval

Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100

modelcontextprotocol/python-sdk#1332 · 1 commentaire · Ouverte le 1/9/2025
Clients Using Storage Face Deadlock on Token Refresh for SSE Ouverte

bug P2 ready for work

Difficulté 4/5 3-5 jours Accessibilité débutants 48/100

modelcontextprotocol/python-sdk#1326 · 4 commentaires · Ouverte le 30/8/2025
Support selection of authorization servers from PRM document Ouverte

auth enhancement

Difficulté 4/5 3-5 jours Accessibilité débutants 35/100

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

auth P1 ready for work

Difficulté 4/5 3-5 jours Accessibilité débutants 48/100

modelcontextprotocol/python-sdk#1318 · 9 commentaires · 6 réactions · Ouverte le 28/8/2025

modelcontextprotocol/python-sdk

Recevez les nouvelles issues par e-mail