Ressources listées ou utilisant un modèle
Proposez des entrées fixes ainsi que des modèles générés à la volée.
Ressources listées ou utilisant un modèle est une leçon MCP Academy gratuite sur CoddyKit. Ceci est la leçon 3 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.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Two Ways to Offer Data
MCP exposes data two ways: a listed resource with a fixed URI, or a templated one with placeholders. Knowing which to pick keeps your server clear.
Listed: Enumerable and Few
A listed resource has a concrete URI and shows up in resources/list. Use it when there are only a handful of known items the client can browse.
@mcp.resource("config://app")
def app_config() -> str:
return read_config()Templated: Infinite by Pattern
A templated resource uses curly-brace placeholders, so it covers countless URIs. It can't be listed in full, because the set is open-ended.
@mcp.resource("file://{path}")
def read_file(path: str) -> str:
return open(path).read()The Listing Difference
Clients call resources/list to discover fixed resources. Templates appear in a separate templates list instead, advertising the shape rather than concrete entries.
Browse vs Address
Think of it as browse vs address. Listed resources are like menu items you scan; templates are like typing an address you already know.
When the Set Is Small
If your data is a short, stable set, prefer listed resources. The model can see every option, which makes the right choice obvious to it.
When the Set Is Huge
If items number in the thousands, a template wins. Listing them all would flood the client, so you advertise the pattern and let it fill in values.
weather://{city}/todayCombine Both Freely
A real server often does both: a few listed entries for common data, plus templates for the long tail. They coexist happily side by side.
Help Discovery Along
Templates can't enumerate, but you can add a small listed index resource that points to popular URIs, giving the model useful starting points.
@mcp.resource("cities://index")
def cities() -> str:
return "london, paris, tokyo"Same Read, Either Way
However a URI is found, the client reads it the same way: one resources/read call. Listed or templated changes discovery, not how content is fetched.
Why This Matters
Choosing listed vs templated shapes how easily a model finds your data. Pick listed for browsing, templated for scale, and your server stays usable. 🎯
Quick Check
Which resource type should you use for thousands of items?
Recap
You learned that listed resources suit small browsable sets while templated ones scale to huge collections, and the two combine well. Next: notifying clients of updates. 🚀
Questions Fréquemment Posées
La leçon « Ressources listées ou utilisant un modèle » est-elle gratuite ?
Oui — le texte complet de « Ressources listées ou utilisant un modèle » 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 « Ressources listées ou utilisant un modèle » ?
Proposez des entrées fixes ainsi que des modèles générés à la volée. 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 3 sur 4.
Combien de temps prend la leçon « Ressources listées ou utilisant un modèle » ?
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