dexblog.ro
Acces rapid: Învață AI Învață Programare Specificații Dispozitive Comparații
MCP Toate conceptele MCP

MCP Inspector (@modelcontextprotocol/inspector) în Model Context Protocol (MCP)

Transport, Configurare & Clienți MCP Inspector (documentația MCP 2026-07-28)

Unealta oficială de testare și depanare a serverelor MCP, cu interfață web, CLI scriptabil și interfață în terminal.

Specificație & cod MCP 
npx @modelcontextprotocol/inspector [--cli | --tui] <comanda server> [argumente]

Ce face MCP Inspector (@modelcontextprotocol/inspector)

MCP Inspector este unealta de referință pentru testarea și depanarea serverelor MCP. Pachetul @modelcontextprotocol/inspector conține trei clienți în același binar: web (implicit, interfață grafică în browser), CLI (--cli, ieșire scriptabilă pentru CI și pipeline-uri) și TUI (--tui, interfață în terminal). Toți folosesc același nucleu: aceleași transporturi, fișiere de configurare, stare OAuth și negociere între era legacy și cea modernă (2026-07-28). Pachetul instalează și mcpdo, un client experimental care păstrează o conexiune deschisă între comenzi. Cere Node 22.19.0 sau mai nou și rulează direct cu npx.

Clientul web afișează un URL care conține un token API generat la fiecare pornire; documentația cere să deschizi acel URL, nu să tastezi localhost:6274 din memorie. Implicit ascultă doar pe 127.0.0.1. Tab-urile apar după capabilitățile serverului: Tools, Prompts, Resources (cu abonare), Logs, plus Protocol (transcriptul JSON-RPC, cu rundele MRTR grupate), Network (pentru servere HTTP, cu antetele Mcp-* evidențiate) și Console (stderr-ul serverelor stdio). Există și tab-uri pentru Apps, Skills și Tasks când serverul le suportă.

Secretele (tokenuri OAuth, client secrets, valori env: pentru stdio) se salvează în keychain-ul sistemului de operare. Pe o mașină fără keychain ajung în ~/.mcp-inspector/secrets.json, necriptate dacă nu dai o cheie. Serverele Python construite cu SDK-ul oficial pot porni Inspector-ul direct cu uv run mcp dev server.py.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
--web / --cli / --tui Modul clientului; cel mult unul, recunoscut doar la începutul liniei de comandă. Implicit web.
--server-url URL --transport http Conectare la un server remote.
--method tools/list În CLI: metoda apelată; ieșirea se poate formata cu --format json.
--tool-name / --tool-arg cheie=valoare În CLI: unealta apelată și argumentele ei.
MCP_AUTO_OPEN_ENABLED=false Nu deschide automat browserul.
MCP_INSPECTOR_API_TOKEN Fixează tokenul API al clientului web, util la porniri din scripturi.
DANGEROUSLY_OMIT_AUTH=true Dezactivează verificarea tokenului; doar pe o mașină unde nimeni altcineva nu ajunge la port.

Exemple practice

Exemplul 1: Interfața web pentru un server local

npx @modelcontextprotocol/inspector node path/to/server/index.js

Exemplul 2: Server publicat pe npm sau PyPI

npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem ~/Desktop
npx @modelcontextprotocol/inspector uvx mcp-server-git --repository ~/code/mcp/servers.git

Exemplul 3: CLI în CI: lista de unelte și un apel

npx @modelcontextprotocol/inspector --cli node path/to/server/index.js --method tools/list

npx @modelcontextprotocol/inspector --cli https://api.example.com/mcp --transport http \
  --method tools/call --tool-name get_weather --tool-arg city=Boston --format json | jq .result

Greșeli frecvente și bune practici

  • Deschizi manual localhost:6274. Backend-ul cere tokenul din URL-ul afișat la pornire, pentru că poate lansa procese pe mașina ta.
  • Expui Inspector-ul în rețea sau setezi DANGEROUSLY_OMIT_AUTH=true pe o mașină partajată. Ambele elimină o barieră de securitate.
  • Rulezi Inspector-ul pe un server necunoscut fără să-i citești README-ul. Fiecare server are alte comenzi și argumente, iar Inspector-ul îl lansează cu permisiunile tale.

Comenzi înrudite