Recursos: dados lidos pelo modelo

Depois das ferramentas vem o resource: dados somente para leitura que seu servidor fornece ao modelo como contexto, como um arquivo, um registro ou um valor de configuração. 📄

Um resource nunca altera o mundo. Ele apenas expõe informações que o modelo pode ler, assim como uma solicitação GET busca uma página sem editar nada.

Cada recurso é endereçado por uma URI, como file:///notes.txt ou config://app. O esquema e o caminho informam aos clientes exatamente o que estão solicitando.

Em Python, você marca uma função com @mcp.resource() e informa sua URI. A função retorna o conteúdo sempre que um cliente lê essa URI.

O que seu recurso retorna se torna o conteúdo que o modelo lê. Strings simples funcionam muito bem para anotações, configurações ou qualquer documento pequeno.

Um recurso também contém um tipo MIME, como text/plain ou application/json. Ele informa ao cliente como interpretar os bytes recebidos.

Os recursos normalmente são controlados pelo aplicativo. O aplicativo hospedeiro ou o usuário escolhe quais anexar, em vez de o modelo obtê-los por conta própria.

Um cliente pode pedir ao seu servidor para listar os recursos. Essa etapa de descoberta permite que um hospedeiro mostre ao usuário quais documentos pode trazer para o contexto.

Para buscar um recurso, o cliente envia uma solicitação de leitura com a URI. Seu servidor executa a função correspondente e retorna o conteúdo atual.

Bons recursos são coisas que você gostaria que a IA visse, mas não executasse: um README, uma linha de banco de dados, uma saída de registro ou as configurações mais recentes.

Um teste simples: se algo faz alguma coisa, transforme-o em ferramenta; se apenas fornece informações para leitura, transforme-o em recurso. Ação versus contexto.

Vamos confirmar para que serve um recurso.

Ótimo! Um recurso é um contexto somente leitura com um URI e um tipo MIME. Os clientes fazem list e leem esses recursos, e o modelo obtém informações sem executar nada. ✅