0Pricing
MCP Academy · Aula

Disponibilizar um recurso de texto estático

Exponha um documento fixo para o modelo ler.

Disponibilizar um recurso de texto estático é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

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. 📄

Perguntas Frequentes

A aula “Disponibilizar um recurso de texto estático” é grátis?

Sim — o texto completo de “Disponibilizar um recurso de texto estático” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.

O que vou aprender em “Disponibilizar um recurso de texto estático”?

Exponha um documento fixo para o modelo ler. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar MCP Academy?

Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Disponibilizar um recurso de texto estático”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de MCP Academy?

Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. URIs de recursos explicadas
  2. Disponibilizar um recurso de texto estático
  3. Ler um arquivo do disco
  4. Definir o tipo MIME correto
← Voltar para MCP Academy