FastMCP vs JSON-RPC manuel pour les serveurs MCP
Lorsqu’on expose des points de terminaison REST à un agent IA via un serveur MCP, le choix entre une abstraction minimale et le protocole brut peut faire gagner — ou gaspiller — des semaines de code rébarbatif. Un développeur en a fait l’expérience à ses dépens en construisant un serveur combinant les données de GitHub et DEV.to : après avoir écrit huit outils manuellement en JSON-RPC, le passage à l’API par décorateurs de FastMCP a été comme échanger une feuille de calcul remplie de schémas contre une seule fonction Python.
Le coût caché du contrôle au niveau protocole
Sous le capot, le MCP repose sur du JSON-RPC via stdio, avec une négociation de capacités et des schémas de requêtes/réponses typés. Coder cette couche soi-même implique, pour chaque outil, d’enregistrer manuellement les noms et descriptions, d’écrire un répartiteur qui extrait les arguments à la main, et de s’assurer que le schéma JSON déclaré reste synchronisé avec les paramètres réels. Avec huit outils, cela représente huit blocs de schéma, une chaîne croissante de if/elif, et huit appels d’emballage des réponses — du code qui n’existe que pour satisfaire le protocole, pas les API sous-jacentes de GitHub ou DEV.to.
Pourquoi l’API par décorateurs de FastMCP l’emporte en pratique
Avec FastMCP, le même outil devient une fonction décorée dont les annotations de type et la docstring génèrent automatiquement le schéma et la description. Le type de retour dicte la forme de la réponse, et aucun répartiteur ni enveloppe protocolaire n’est nécessaire. Ajouter un neuvième outil tient en une ligne : écrire la fonction, ajouter @mcp.tool(), et l’agent peut l’appeler immédiatement. Le dossier de décision architecturale du projet résume bien : « Une complexité superflue pour ce cas d’usage. »
Quand le bas niveau a du sens
L’API MCP brute existe pour les auteurs de bibliothèques ou les cas nécessitant des résultats partiels en flux continu, une négociation de capacités personnalisée, ou des transports non standards. Si l’objectif se limite à exposer des enveloppes REST à un agent, la couche d’abstraction se justifie par sa maintenabilité et sa rapidité de développement.
Pourquoi c’est important
Pour les équipes qui livrent rapidement des serveurs MCP, FastMCP élimine toute une catégorie de code répétitif sujet aux erreurs, sans sacrifier la correction. Les enjeux réels portent sur la vitesse d’itération : un seul décorateur peut remplacer des dizaines de lignes de plomberie protocolaire, permettant aux développeurs de se concentrer sur la logique métier plutôt que sur les détails du JSON-RPC. Dans un écosystème où l’adoption du MCP s’accélère, choisir la bonne abstraction dès le départ peut faire la différence entre un serveur maintenable et un amas grandissant de déchets spécifiques au protocole.
Source : DEV Community. Synthèse éditoriale assistée par IA — TechnoExpress.