MCP Resources & Resource Templates (URI) în Model Context Protocol (MCP)

Primitiva MCP pentru expunerea datelor de tip read-only (fișiere, scheme de baze de date, loguri, documentație) identificate prin adrese URI standardizate.

Specificație & cod MCP
// URI-uri statice și dinamice (RFC 6570 URI Templates):
postgres://localhost/clienti/schema
file:///var/log/nginx/error.log
crm://clienti/{id_client}/istoric_comenzi

Descriere & Utilizare

Resources (Resursele) reprezintă modalitatea standard prin care un Server MCP expune date și context către aplicația AI, fără a executa acțiuni cu efecte secundare (similar cu o cerere HTTP GET).

Spre deosebire de Tools, resursele sunt controlate de aplicație sau de utilizator (Application/User-controlled): în interfețe precum Claude Desktop sau Cursor, utilizatorul poate selecta explicit o resursă din meniul de atașamente (sau cu simbolul @) pentru a o injecta în contextul conversației.

Serverele pot expune atât Resurse statice (ex: schema tabelelor SQL), cât și Resource Templates dinamice cu parametri în URI (ex: github://repo/{owner}/{name}/readme), plus notificări în timp real (resources/updated) când fișierul sursă se modifică.

Cum să o reții ușor

💡 Ca dosarele dintr-un dulap etichetat cu coduri de bare (URI): le poți deschide și fotografia oricând pentru a le arăta consultantului AI, cu garanția că simpla lor citire nu modifică nimic în firmă.

Opțiuni și parametri tehnici

  • uri: identificatorul unic al resursei (ex: file:///..., postgres://..., custom://...).
  • mimeType: tipul conținutului returnat (text/plain, application/json, text/markdown, image/png).
  • resources/list & resources/templates/list: metodele de descoperire a resurselor fixe și a șabloanelor cu parametri.
  • resources/subscribe: permite clientului să fie notificat automat când conținutul unei resurse s-a schimbat.

Exemple practice și cazuri de utilizare

  • Expunerea schemei bazei de date ca resursă: db://schema/tabele oferă modelului structura coloanelor înainte ca acesta să apeleze unealta run_sql_query.
  • Citirea logurilor aplicației: logs://app/azi returnează ultimele 200 de linii de eroare în format text/plain.
  • Șablon dinamic pentru profilul unui client: crm://client/{cui}.

Sfaturi de configurare & capcane

Combină Resources cu Tools: expune schema bazei de date și dicționarul de coduri ca Resource și lasă interogarea efectivă SQL ca Tool.

Comenzi și ghiduri înrudite