modelcontextprotocol / modelcontextprotocol/python-sdk

Introduce typed error classes with metadata

Aperta
#1,742 1 commento 3 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

breaking change enhancement P2 v2
Lingua principale
Python
Stelle
24.3k
Fork
4k
Merge medio
1g 1h
PR unite (30g)
31

Descrizione

Summary

Replace generic exceptions with SDK-native error classes that include useful metadata like fault attribution, retryability, and HTTP details.

Problem

The SDK currently raises generic exceptions from various layers (httpx, anyio, task groups) with no context about:

  • Whether the error is retryable
  • Who is at fault (client, server, network, protocol violation)
  • HTTP status codes and response bodies (often discarded)

This makes it hard for users to build robust error handling.

Goal

A hierarchy of typed errors like:

  • McpError (base) with fault, is_retryable, http_status_code, response_body
  • McpTransportError for connection/network issues
  • McpProtocolError for invalid JSON-RPC responses
  • McpAuthError for 401/403 responses

AI Disclaimer

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia tracciando dove l'SDK espone attualmente eccezioni generiche provenienti da httpx, anyio e gruppi di attività. Definisci l'ambito e i requisiti dei metadati per la gerarchia McpError proposta, inclusi l'attribuzione del fault, la possibilità di ritentare, i codici di stato HTTP e i corpi delle risposte. Il lavoro è completato quando il design è stato risolto e i percorsi di errore interessati espongono in modo coerente errori tipizzati nativi dell'SDK.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
api, backend
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Tranquilla
Chiarezza
Da chiarire
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.