Proiect final 1: serverul MCP al magazinului
Prima parte a proiectului: server_magazin.py, serverul MCP prin care agentul ajunge la comenzile, livrările și retururile CasaNova. Îl scrii cu tot ce ai învățat în modulul 4: tool-uri cu erori utile, adnotări, o resursă, loguri și confirmarea clientului prin elicitation. Și îl testezi automat, înainte să-l dai unui agent.
Contractul serverului
Un server MCP e un contract: ce tool-uri are, ce primesc, ce întorc și ce erori dau. Îl fixezi întâi pe hârtie, pentru că agentul (lecția 66), garda (67) și evaluarea (68) se vor baza pe aceleași nume și aceleași mesaje.
Completează server_magazin.py: tool-ul cauta_comanda, ajutorul _comanda și schema ConfirmareRetur sunt gata. Scrie status_livrare, initiaza_retur și resursa magazin://politica-retur după contractul din lecție. Testele de la final (nu le mod…
- status_livrare(awb: str) -> str cu @mcp.tool(annotations=ToolAnnotations(readOnlyHint=True)) și docstring: awb.strip().upper(), ToolError dacă nu e în LIVRARI, altfel f"{awb}: {LIVRARI[awb]}".
- async def initiaza_retur(numar: str, motiv: str, ctx: Context) -> str cu destructiveHint=True: validările în ordine (există, livrată, în termen), cu raise ToolError și mesajele din lecție.
- Dacă returul comenzii e deja în RETURURI, întoarce Returul pentru comanda 10421 este deja inițiat. fără să mai ceri confirmarea.
- Cere confirmarea cu await ctx.elicit(message=..., schema=ConfirmareRetur); la refuz: log + Returul nu a fost inițiat: clientul nu a confirmat.; la accept: codul R-5001, RETURURI.append({"cod", "comanda", "motiv", "suma"}), log + mesajul de succes.
Restul explicațiilor, editorul și verificarea automată se deblochează cu Proiect final și interviu.

Ioana Dumitrache
Marina Pahom
Alex Cristian