URI de ressources paramétrées
Récupérez directement les variables dans le chemin de l’URI.
URI de ressources paramétrées est une leçon MCP Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage MCP Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours MCP Academy comprend 4 leçons au total.
Un modèle, de nombreuses ressources
Une ressource statique possède une adresse fixe. Un URI paramétré est un modèle qui représente toute une famille de ressources à la fois. ✨
Des espaces réservés entre accolades
Vous indiquez la partie variable d’un URI avec un espace réservé entre accolades, comme users://{user_id}/profile. Cette paire d’accolades représente un emplacement à remplir.
users://{user_id}/profileLe modèle est une promesse
Un modèle de ressource indique au client que tout URI correspondant à cette forme est valide. Le modèle peut y insérer de vraies valeurs pour demander exactement ce dont il a besoin.
Décorer pour enregistrer
Dans le SDK Python, vous enregistrez un modèle comme un outil : avec le décorateur @mcp.resource, en lui transmettant le modèle d’URI comme argument.
@mcp.resource("users://{user_id}/profile")
def get_profile(user_id: str) -> str:
return f"Profile for {user_id}"Les noms doivent correspondre
Chaque espace réservé de l’URI doit apparaître comme paramètre de fonction portant le même nom. Le SDK relie directement {user_id} à votre argument user_id.
Capturer plusieurs éléments
Vous pouvez capturer plusieurs variables dans un même URI. Chaque espace réservé correspond à son propre paramètre, ce qui permet à un seul modèle de cibler des données très précises.
@mcp.resource("repos://{owner}/{name}/readme")
def readme(owner: str, name: str) -> str:
return load_readme(owner, name)Les valeurs arrivent sous forme de chaînes
Les éléments capturés arrivent sous forme de texte depuis l’URI. Si vous avez besoin d’un nombre, convertissez-le vous-même dans la fonction avant de l’utiliser.
def get_page(page: str) -> str:
n = int(page)
return render_page(n)Un segment par espace réservé
Par défaut, un espace réservé capture un seul segment de chemin, c’est-à-dire le texte situé entre deux barres obliques. Il s’arrête à la barre suivante et n’engloutit donc pas le reste du chemin.
Les modèles ne se listent pas eux-mêmes
Une ressource simple apparaît dans la liste des ressources. Une ressource basée sur un modèle n’y apparaît généralement pas, car les URI possibles sont innombrables. Le client la lit en complétant le modèle.
Garder des URI explicites
Concevez des URI qui ressemblent à des adresses claires, comme weather://{city}/today. Un modèle choisit beaucoup plus sûrement la bonne ressource lorsque le chemin est explicite.
weather://{city}/todayPourquoi est-ce important ?
Les URI paramétrés permettent à une seule fonction bien organisée de servir des milliers de ressources. Vous définissez la structure une seule fois, puis les parties variables font le reste. 🎯
Vérification rapide
Comment un espace réservé d’URI capturé parvient-il jusqu’à votre fonction ?
Récapitulatif
Vous avez appris que les URI paramétrés utilisent des espaces réservés entre accolades pour servir toute une famille de ressources, chacun étant associé à un paramètre de fonction correspondant. Ensuite : construire leur contenu. 🚀
Questions Fréquemment Posées
La leçon « URI de ressources paramétrées » est-elle gratuite ?
Oui — le texte complet de « URI de ressources paramétrées » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours MCP Academy, passe à CoddyKit PRO. Le cours MCP Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « URI de ressources paramétrées » ?
Récupérez directement les variables dans le chemin de l’URI. Tu pratiques MCP Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer MCP Academy ?
Aucune expérience préalable n'est requise. MCP Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « URI de ressources paramétrées » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon MCP Academy ?
Oui. Chaque leçon MCP Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- URI de ressources paramétrées
- Générer le contenu lors de la lecture
- Ressources listées ou utilisant un modèle
- Notifier les clients des mises à jour