Fournir une ressource textuelle statique
Exposez un document fixe que le modèle peut lire.
Fournir une ressource textuelle statique est une leçon MCP Academy gratuite sur CoddyKit. Ceci est la leçon 2 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.
A Fixed Document
The simplest resource is a static one: a fixed string your server returns every time. Great for help text, policies, or config notes.
One Function, One URI
You expose it by writing a Python function and tagging it with a resource URI. When a client reads that URI, your function runs and returns text.
The Decorator
The resource decorator registers the function under its URI. The string you pass becomes the address clients use to fetch the content.
@mcp.resource("info://welcome")
def welcome():
return "Welcome to the server!"Return Plain Text
For a text resource, just return a Python string. The SDK wraps it into the proper MCP read response so the client receives clean content.
Name and Describe It
Give the resource a clear description so the model knows when to read it. A docstring on the function is used as that description.
@mcp.resource("info://welcome")
def welcome():
"Greeting shown to new users."
return "Hello there!"Static Means No Inputs
A static resource takes no parameters; it always yields the same body. If you need to vary output, that is a job for templates, covered later.
Build Text in Code
The return value can be assembled in Python before sending. The result is still static to the client, since the same call gives the same text.
@mcp.resource("config://limits")
def limits():
return "max_items=100\ntimeout=30"Why Resources, Not Tools
Use a resource when the model only needs to read context. Tools are for actions; reading reference text is exactly what resources are for.
The Model Pulls It In
Many hosts let the user attach a resource to a chat, dropping its content into context. The model then reasons over that text alongside the prompt.
Keep It Lightweight
Static resources load fast since there is no work to do. Reserve them for small, stable text so you do not flood the model with tokens.
Test Your Resource
Run the server and use a client to list and read the URI. Seeing your exact string come back confirms the resource is wired correctly.
Quick Check
Choosing the right primitive for fixed text.
Recap
A static resource is a function under a URI that returns fixed text. Add a docstring description and keep the body small. 📄
Questions Fréquemment Posées
La leçon « Fournir une ressource textuelle statique » est-elle gratuite ?
Oui — le texte complet de « Fournir une ressource textuelle statique » 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 « Fournir une ressource textuelle statique » ?
Exposez un document fixe que le modèle peut lire. 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 2 sur 4.
Combien de temps prend la leçon « Fournir une ressource textuelle statique » ?
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
- Comprendre les URI de ressources
- Fournir une ressource textuelle statique
- Lire un fichier sur le disque
- Définir le bon type MIME