modelcontextprotocol / modelcontextprotocol/python-sdk

Introduce typed error classes with metadata

Ouverte
#1,742 1 commentaire 3 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

breaking change enhancement P2 v2
Langage dominant
Python
Étoiles
24.3k
Forks
4k
Merge moyen
1 j 1 h
PR mergées (30 j)
31

Description

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

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par suivre les endroits où le SDK expose actuellement des exceptions génériques provenant de httpx, anyio et des groupes de tâches. Définissez la portée et les exigences de métadonnées pour la hiérarchie McpError proposée, notamment l’attribution de la faute, la possibilité de réessayer, les codes d’état HTTP et les corps des réponses. Le travail est terminé lorsque la conception est arrêtée et que les chemins d’erreur concernés exposent systématiquement des erreurs typées natives du SDK.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
python
Domaine
api, backend
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
Calme
Clarté
À clarifier
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.