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

Instrumentul oficial cu interfață web (tip Postman pentru MCP) pentru testarea, depanarea și inspectarea interactivă a uneltelor, resurselor și mesajelor JSON-RPC ale unui server MCP.

Specificație & cod MCP
# Testarea unui server MCP scris în Python (FastMCP):
npx @modelcontextprotocol/inspector uv run server.py

# Testarea unui server MCP Node.js / TypeScript:
npx @modelcontextprotocol/inspector node build/index.js

Descriere & Utilizare

Când dezvolți propriul tău Server MCP în Python sau TypeScript, testarea lui direct în Claude Desktop sau Cursor este greoaie: la fiecare modificare trebuie să repornești aplicația și să ghicești ce parametri a trimis LLM-ul.

MCP Inspector (@modelcontextprotocol/inspector) este instrumentul oficial de dezvoltare și depanare: pornește o interfață web locală (de obicei pe http://localhost:6274) care acționează ca un Host MCP complet controlat de tine.

În interfața Inspectorului poți vedea toate uneltele expuse (Tools), poți completa formulare pentru a le apela manual, poți citi Resources, poți testa Prompts și poți urmări în timp real fiecare mesaj JSON-RPC și ieșirea de eroare (stderr).

Cum să o reții ușor

💡 Exact ceea ce este Postman sau Swagger UI pentru API-urile REST, MCP Inspector este pentru serverele Model Context Protocol: un banc de probă vizual cu raze X.

Opțiuni și parametri tehnici

  • Transport Type (STDIO / SSE / Streamable HTTP): poți testa atât scripturi locale, cât și servere MCP găzduite în cloud.
  • Environment Variables: panou în interfața web unde poți injecta chei API de test fără a le scrie în cod.
  • Notifications & Request History: jurnal cronologic cu durata în milisecunde și payload-ul JSON al fiecărui apel.

Exemple practice și cazuri de utilizare

  • Lansare rapidă prin CLI-ul FastMCP: mcp dev server.py (care pornește automat MCP Inspector atașat la scriptul tău Python).
  • Verificarea schemei JSON generate: în tabul Tools din Inspector vezi exact dacă descrierile și tipurile deduse din type hints sunt corecte.
  • Testarea unui server remote: rulează npx @modelcontextprotocol/inspector fără argumente și introdu URL-ul HTTP/SSE direct în browser.

Sfaturi de configurare & capcane

Testează întotdeauna serverul nou în MCP Inspector înainte de a-l adăuga în claude_desktop_config.json — vei descoperi în 5 secunde orice eroare de import sau de sintaxă JSON Schema.

Comenzi și ghiduri înrudite