Ofereça recursos e prompts
Exponha contexto por URIs e modelos reutilizáveis com argumentos, protegendo os caminhos.
- Listar, ler e criar modelos de URI para recursos
- Usar anotações para indicar contexto relevante
- Retornar mensagens de prompt e impedir path traversal
Um recurso é um dado identificado por URI, como file:///project/README.md, git://repo/main ou crm://customers/42. Clientes os descobrem com resources/list e os leem com resources/read. Quando há muitos dados para listar, ofereça modelos de recursos com variáveis, como weather://{city}/today.
Um prompt tem nome, descrição e argumentos opcionais. prompts/get retorna mensagens com papel e conteúdo, prontas para iniciar uma conversa. Hosts costumam apresentar prompts como comandos de barra.
1{
2 "jsonrpc": "2.0",
3 "id": 2,
4 "result": {
5 "resultType": "complete",
6 "contents": [
7 {
8 "uri": "file:///project/src/main.rs",
9 "mimeType": "text/x-rust",
10 "text": "fn main() {\n println!(\"Hello world!\");\n}"
11 }
12 ],
13 "ttlMs": 60000,
14 "cacheScope": "private"
15 }
16}Recursos e conteúdos podem trazer anotações para ajudar o host a decidir o que incluir: audience ("user", "assistant" ou ambos), priority de 0 (opcional) a 1 (praticamente obrigatório) e lastModified.
Prompts
Um prompt tem nome, descrição e argumentos opcionais. prompts/get recebe os argumentos e devolve uma lista de mensagens, cada uma com role (user ou assistant) e conteúdo, prontas para iniciar uma conversa. Hosts costumam apresentá-los como comandos de barra.
1{
2 "jsonrpc": "2.0",
3 "id": 2,
4 "result": {
5 "resultType": "complete",
6 "description": "Prompt de revisão de código",
7 "messages": [{
8 "role": "user",
9 "content": { "type": "text", "text": "Revise este código Python:\ndef hello():\n print('mundo')" }
10 }]
11 }
12}Principais conclusões
Recursos são dados identificados por URI; modelos representam famílias de URIs.
Prompts retornam mensagens prontas para iniciar uma interação.
Valide o caminho resolvido para impedir acesso fora da raiz permitida.
Quiz da aula
6 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: crie um servidor MCP
Escreva código Python no editor e execute os testes com exemplos. O Python roda localmente no navegador usando WebAssembly.
Expanda um modelo de URI
A primeira linha contém um modelo com variáveis {name}; a segunda, um objeto JSON com os valores. Substitua cada variável e imprima o URI. Se faltar um valor, imprima missing NAME para a primeira variável ausente.
- Duas variáveis
- Valor ausente
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Bloqueie path traversal
A primeira linha informa a pasta raiz absoluta. Cada linha seguinte é um caminho relativo solicitado. Imprima allow FULL_PATH se o caminho normalizado ficar dentro da raiz; caso contrário, imprima deny REQUESTED.
- Caminho normal e tentativa de escapar
- Pasta irmã e caminho absoluto
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…