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

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

bug needs confirmation P2

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

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

bug needs confirmation P2

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

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

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2727 · 3 commentaires · Ouverte le 30/5/2026
FastMCP: streamable_http_app() silently breaks when BaseHTTPMiddleware is added Ouverte

bug needs repro P3 potentially close

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

modelcontextprotocol/python-sdk#2702 · 5 commentaires · Ouverte le 27/5/2026
`ClientSessionGroup` attempts to use capabilities that were not advertised Ouverte

bug fix proposed P2 ready for work

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

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

auth bug fix proposed P2 ready for work

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

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

bug P2 ready for work

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

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

enhancement needs decision P3

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

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

bug fix proposed P3 ready for work

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

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

bug fix proposed P2 ready for work

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

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

bug needs repro

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

modelcontextprotocol/python-sdk#2653 · 3 commentaires · Ouverte le 21/5/2026
DCR registration accepts redirect_uris with non-HTTPS / non-loopback / fragmented schemes Ouverte

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2629 · 1 commentaire · Ouverte le 18/5/2026
Add option to skip output validation for mcp client Ouverte

enhancement needs decision P3

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

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

bug needs confirmation P2 potentially close

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

modelcontextprotocol/python-sdk#2610 · 3 commentaires · Ouverte le 15/5/2026
Duplicate `initialize` with changed parameters can overwrite `ServerSession.client_params` Ouverte

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2605 · 4 commentaires · Ouverte le 15/5/2026
`ClientConfig` has inconsistent naming: `message_handler` should be `message_callback` Ouverte

enhancement needs decision P3 v2

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

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

enhancement needs decision P3

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

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

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2578 · 6 commentaires · Ouverte le 12/5/2026
raise without from discards exception chain in 12 remaining sites Ouverte

bug P3

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

modelcontextprotocol/python-sdk#2564 · 3 commentaires · Ouverte le 8/5/2026
Add `list_all_*` helpers to drain pagination Ouverte

enhancement P3 v2

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

modelcontextprotocol/python-sdk#2556 · 3 commentaires · Ouverte le 8/5/2026
Split the core from the server and client implementations Ouverte

enhancement needs decision P3 v2

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

modelcontextprotocol/python-sdk#2486 · 4 commentaires · Ouverte le 21/4/2026
Return 405 on GET when stateless_http=True Ouverte

bug P2

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

modelcontextprotocol/python-sdk#2474 · 4 commentaires · 2 réactions · Ouverte le 19/4/2026
MCPServer unconditionally declares `prompts`, `resources`, `tools` capabilities on `initialize` Ouverte

bug P2

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

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

bug fix proposed P2 ready for work

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

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

bug fix proposed P2 ready for work

Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100

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

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2432 · 3 commentaires · Ouverte le 13/4/2026
McpError is not pickle-safe and fails to unpickle Ouverte

bug fix proposed P2 ready for work

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

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

bug fix proposed P2 ready for work

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

modelcontextprotocol/python-sdk#2429 · 2 commentaires · Ouverte le 13/4/2026
Specific ToolNotFoundError for easier handling than ToolError in multi-tenant environments Ouverte

enhancement needs decision P3

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

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

bug fix proposed P2 ready for work

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

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

bug P2

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

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

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2384 · 2 commentaires · Ouverte le 2/4/2026
ClientSession: add public API for updating callbacks after initialization Ouverte

enhancement needs decision P3

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

modelcontextprotocol/python-sdk#2379 · 4 commentaires · Ouverte le 30/3/2026
Image/ImageContent serialization fails in stateless HTTP mode Ouverte

bug needs confirmation P2

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

modelcontextprotocol/python-sdk#2376 · 3 commentaires · 5 réactions · Ouverte le 29/3/2026
Design: future of `dependencies` parameter on MCPServer Ouverte

enhancement needs decision P2 v2

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

modelcontextprotocol/python-sdk#2354 · 2 commentaires · 4 réactions · Ouverte le 26/3/2026
Add remove_prompt() and remove_resource() for parity with remove_tool() Ouverte

enhancement needs decision P3

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

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

enhancement P3

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

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

auth enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2317 · 5 commentaires · Ouverte le 20/3/2026
Mark SSE transport as deprecated Ouverte

improves sdk consistency improves spec compliance P3 v2

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

modelcontextprotocol/python-sdk#2278 · 1 commentaire · Ouverte le 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 Ouverte

enhancement needs decision P2

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

modelcontextprotocol/python-sdk#2233 · 3 commentaires · Ouverte le 6/3/2026
Bug: validate_scope rejects client scopes when required scopes in None Ouverte

auth bug P2 ready for work

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

modelcontextprotocol/python-sdk#2216 · 5 commentaires · Ouverte le 5/3/2026
Type the MCPServer handler pipeline: tool/resource/prompt return types Ouverte

enhancement v2

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

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

enhancement v2

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

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

bug P2 ready for work

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

modelcontextprotocol/python-sdk#2150 · 3 commentaires · Ouverte le 26/2/2026
Add wildcard pattern support for `allowed_hosts` in transport security Ouverte

enhancement needs confirmation

modelcontextprotocol/python-sdk#2141 · 1 commentaire · 1 personne assignée · Ouverte le 25/2/2026
Allow `OAuthClientProvider` to accept a pre-configured auth server URL Ouverte

auth enhancement needs confirmation

modelcontextprotocol/python-sdk#2121 · 1 personne assignée · Ouverte le 21/2/2026
Support MCP client session resumption (sessionId reuse) in Python SDK Ouverte

enhancement P2 v2

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

modelcontextprotocol/python-sdk#2116 · 2 commentaires · 1 réaction · Ouverte le 20/2/2026
ExceptionGroup wrapping obscures real errors from task groups Ouverte

bug P1 v2

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

modelcontextprotocol/python-sdk#2114 · 3 commentaires · 2 réactions · Ouverte le 19/2/2026
HTTP transport swallows non-2xx status codes causing client to hang Ouverte

bug P1 v2

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

modelcontextprotocol/python-sdk#2110 · 7 commentaires · 2 réactions · Ouverte le 19/2/2026
Expose session, auth, and transport information on handler Context Ouverte

enhancement P1 v2

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

modelcontextprotocol/python-sdk#2098 · 1 commentaire · Ouverte le 19/2/2026

modelcontextprotocol/python-sdk

Recevez les nouvelles issues par e-mail