Modulul 04 · 10 min

MCP Servers

Extinderea capabilitatilor agentului cu servere externe prin Model Context Protocol.

Ce este MCP?

Model Context Protocol este un standard care permite agentilor AI sa se conecteze la servere externe pentru a accesa date si capabilitati suplimentare. Gandeste-te la MCP servers ca la plugin-uri pentru agent.

💡 Analogie

Daca agentul AI este un browser, MCP servers sunt extensiile (add-on-urile) care ii dau capabilitati noi: acces la documentatie, memorie persistenta, gandire structurata.

Configurare: .mcp.json

Fisierul .mcp.json din radacina proiectului defineste ce servere MCP sunt disponibile:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"],
      "scope": "project"
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": { "MEMORY_FILE": ".claude/memory.json" },
      "scope": "project"
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
      "defaultConfig": { "deferred_loading": true },
      "scope": "project"
    }
  }
}

Cele 3 servere din v2.1

1. Context7 — Documentatie up-to-date

Claude are cunostinte pana la un anumit cutoff date. Context7 ii da acces la documentatia actuala a framework-urilor (Next.js, React, etc.).

Agentul il intreaba: "Care e sintaxa pentru X in Next.js 15?"
Context7 returneaza documentatia actualizata
deferred_loading: false — incarcat imediat la start sesiune

2. Memory — Knowledge graph persistent

Stocat in .claude/memory.json, acest server mentine un knowledge graphcu entitati si relatii. Este Layer 3 din cele 6 layere de memorie.

Stocheaza fapte: "Proiectul foloseste TypeScript"
Stocheaza decizii: "Am ales Tailwind in loc de CSS modules"
Stocheaza pattern-uri: "Testele TDD au prins 2 bug-uri in Phase 001"

ℹ️ Info

Spre deosebire de MEMORY.md (text liber, auto-incarcat), knowledge graph-ul MCP stocheaza relatii structurate pe care agentul le poate interoga specific.

3. Sequential Thinking — Gandire pas cu pas

Un server care ajuta agentul sa gandeasca mai structurat pentru probleme complexe. Are deferred_loading: true — nu se incarca decat cand e nevoie de el.

⚠️ Deferred vs Immediate

Serverele cu deferred_loading: true nu ocupa resurse pana cand agentul nu le invoca explicit. Serverele false (context7, memory) sunt disponibile imediat — dar consuma resurse la fiecare sesiune.

Cum interactioneaza agentul cu MCP

Agentul nu apeleaza MCP direct prin cod — foloseste tool-uri expuse de fiecare server:

# Agentul poate face:
mcp__context7__resolve_library_id("next.js")
mcp__memory__create_entity("Phase001", "completed")
mcp__memory__search_nodes("TDD")

Aceste tool-uri apar automat in lista de tool-uri disponibile cand serverul e conectat.

Exercitiu

Deschide .mcp.json si .claude/memory.json din acest proiect. Observa structura knowledge graph-ului: ce entitati exista, ce relatii au intre ele.

Verifica-ti cunostintele

Ce stocheaza MCP Memory Server?