Az MCP Inspektor egy alapvető hibakereső eszköz, amely lehetővé teszi, hogy interaktívan teszteld és hibajavítsd MCP szervereidet anélkül, hogy egy teljes AI host alkalmazásra lenne szükség. Gondolj rá úgy, mint az „MCP Postmanje” – vizuális felületet biztosít kérésküldéshez, válaszok megtekintéséhez, és megértéséhez, hogyan viselkedik a szervered.
MCP szerverek építése közben gyakran szembesülhetsz az alábbi kihívásokkal:
- „Fut-e egyáltalán a szerverem?” – Az Inspektor mutatja a kapcsolat állapotát
- „Megfelelően regisztráltam az eszközeimet?” – Az Inspektor megjeleníti az összes elérhető eszközt
- „Mi a válasz formátuma?” – Az Inspektor megjeleníti a teljes JSON válaszokat
- „Miért nem működik ez az eszköz?” – Az Inspektor részletes hibajelentéseket mutat
- Node.js 18+ telepítve
- npm (a Node.js része)
- Egy tesztelendő MCP szerver (lásd Module 3.1 - First Server)
npx @modelcontextprotocol/inspectornpm install -g @modelcontextprotocol/inspector
mcp-inspectorcd your-mcp-server-project
npm install --save-dev @modelcontextprotocol/inspectorAdd hozzá a package.json-hoz:
{
"scripts": {
"inspector": "mcp-inspector"
}
}Azokhoz a szerverekhez, amelyek a szabványos bemeneten/kimeneten keresztül kommunikálnak:
# Python szerver
npx @modelcontextprotocol/inspector python -m your_server_module
# Node.js szerver
npx @modelcontextprotocol/inspector node ./build/index.js
# Környezeti változókkal
OPENAI_API_KEY=xxx npx @modelcontextprotocol/inspector python server.pyAzokhoz a szerverekhez, amelyek HTTP szolgáltatásként futnak:
-
Indítsd el először a szerveredet:
python server.py # Szerver fut a http://localhost:8080 címen -
Indítsd el az Inspektort és csatlakozz:
npx @modelcontextprotocol/inspector --sse http://localhost:8080/sse
Amikor elindul az Inspektor, egy webes felületet látsz (általában a http://localhost:5173 címen):
┌─────────────────────────────────────────────────────────────┐
│ MCP Inspector [Connected ✅] │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 🔧 Tools │ │ 📄 Resources│ │ 💬 Prompts │ │
│ │ (3) │ │ (2) │ │ (1) │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ 📋 Message Log │ │
│ │ ─────────────────────────────────────────────────── │ │
│ │ → initialize │ │
│ │ ← initialized (server info) │ │
│ │ → tools/list │ │
│ │ ← tools (3 tools) │ │
│ └───────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
- Kattints a Tools fülre
- Az Inspektor automatikusan meghívja a
tools/list-et - Megjelennek az összes regisztrált eszköz:
- Eszköz neve
- Leírása
- Bemeneti séma (paraméterek)
- Válassz ki egy eszközt a listából
- Töltsd ki a szükséges paramétereket a űrlapon
- Kattints a Run Tool gombra
- Nézd meg a választ az eredmény panelen
Példa: Kalkulátor eszköz tesztelése
Tool: add
Parameters:
a: 25
b: 17
Response:
{
"content": [
{
"type": "text",
"text": "42"
}
]
}
Ha egy eszköz hibát jelez, az Inspektor megmutatja:
Error Response:
{
"error": {
"code": -32602,
"message": "Invalid params: 'b' is required"
}
}
Gyakori hibakódok:
| Kód | Jelentés |
|---|---|
| -32700 | Elemzési hiba (érvénytelen JSON) |
| -32600 | Érvénytelen kérés |
| -32601 | Nincs ilyen metódus |
| -32602 | Érvénytelen paraméterek |
| -32603 | Belső hiba |
- Kattints a Resources fülre
- Az Inspektor meghívja a
resources/list-et - Megjelenik:
- Erőforrás URI-k
- Nevek és leírások
- MIME típusok
- Válassz ki egy erőforrást
- Kattints a Read Resource gombra
- Nézd meg a visszakapott tartalmat
Példa kimenet:
Resource: file:///config/settings.json
Content-Type: application/json
{
"config": {
"debug": true,
"maxConnections": 10
}
}
- Kattints a Prompts fülre
- Az Inspektor meghívja a
prompts/list-et - Nézd meg az elérhető parancs-sablonokat
- Válassz ki egy parancsot
- Töltsd ki a szükséges argumentumokat
- Kattints a Get Prompt gombra
- Nézd meg a renderelt parancs üzeneteket
Az üzenetnapló megjeleníti az összes MCP protokoll üzenetet:
14:32:01 → {"jsonrpc":"2.0","id":1,"method":"initialize",...}
14:32:01 ← {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-11-25",...}}
14:32:02 → {"jsonrpc":"2.0","id":2,"method":"tools/list"}
14:32:02 ← {"jsonrpc":"2.0","id":2,"result":{"tools":[...]}}
14:32:05 → {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"add",...}}
14:32:05 ← {"jsonrpc":"2.0","id":3,"result":{"content":[...]}}
- Kérés/válasz párok: Minden
→-hoz tartozik kapcs← - Hibajelzések: Keress
"error"mezőket a válaszokban - Időzítés: Nagy szünetek teljesítmény problémára utalhatnak
- Protokoll verzió: Győződj meg róla, hogy a szerver és kliens egyezik verzióban
Az Inspektort közvetlenül a VS Code-ból is futtathatod:
Add hozzá a .vscode/launch.json-hoz:
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug with MCP Inspector",
"type": "node",
"request": "launch",
"runtimeExecutable": "npx",
"runtimeArgs": [
"@modelcontextprotocol/inspector",
"python",
"${workspaceFolder}/server.py"
],
"console": "integratedTerminal"
},
{
"name": "Debug SSE Server with Inspector",
"type": "chrome",
"request": "launch",
"url": "http://localhost:5173",
"preLaunchTask": "Start MCP Inspector"
}
]
}Add hozzá a .vscode/tasks.json-hoz:
{
"version": "2.0.0",
"tasks": [
{
"label": "Start MCP Inspector",
"type": "shell",
"command": "npx @modelcontextprotocol/inspector node ${workspaceFolder}/build/index.js",
"isBackground": true,
"problemMatcher": {
"pattern": {
"regexp": "^$"
},
"background": {
"activeOnStart": true,
"beginsPattern": "Inspector",
"endsPattern": "listening"
}
}
}
]
}Jelenségek: Az Inspektor „Disconnected” státuszt mutat vagy „Connecting...” állapotban marad
Ellenőrző lista:
- ✅ Helyes a szerver parancs?
- ✅ Minden függőség telepítve van?
- ✅ A szerver elérési útja abszolút vagy a jelenlegi könyvtárhoz relatív-e?
- ✅ Minden szükséges környezeti változó be van állítva?
Hibakeresési lépések:
# Először manuálisan teszteld a szervert
python -c "import your_server_module; print('OK')"
# Ellenőrizd az import hibákat
python -m your_server_module 2>&1 | head -20
# Győződj meg róla, hogy az MCP SDK telepítve van
pip show mcpJelenségek: Az eszközök fül üres listát mutat
Lehetséges okok:
- Az eszközök nincsenek regisztrálva a szerver indításakor
- A szerver összeomlott indítás után
- A
tools/listkezelő üres tömböt ad vissza
Hibakeresési lépések:
- Ellenőrizd az üzenetnaplót a
tools/listválaszért - Adj naplózást az eszköz regisztrációs kódodhoz
- Ellenőrizd, hogy jelen vannak-e a
@mcp.tool()dekorátorok (Python esetén)
Jelenségek: Az eszköz hívása hibás választ ad
Hibakeresési megközelítés:
- Olvasd el alaposan a hibaüzenetet
- Ellenőrizd, hogy a paraméter típusai megfelelnek a sémának
- Adj try/catch blokkot részletes hibaüzenetekkel
- Nézd meg a szerver naplókat a stack trace-hez
Példa javított hibakezelésre:
@mcp.tool()
async def my_tool(param1: str, param2: int) -> str:
try:
# Itt van az eszköz logikája
result = process(param1, param2)
return str(result)
except ValueError as e:
raise McpError(f"Invalid parameter: {e}")
except Exception as e:
raise McpError(f"Tool failed: {type(e).__name__}: {e}")Jelenségek: Az erőforrás visszatér, de a tartalom üres vagy null
Ellenőrző lista:
- ✅ A fájl elérési útja vagy URI helyes
- ✅ A szervernek engedélye van az erőforrás olvasására
- ✅ Az erőforrás tartalma helyesen vissza van adva
npx @modelcontextprotocol/inspector \
--sse http://localhost:8080/sse \
--header "Authorization: Bearer your-token"DEBUG=mcp* npx @modelcontextprotocol/inspector python server.pyAz Inspektor exportálhatja az üzenetnaplókat későbbi elemzéshez:
- Kattints az Export Log gombra az üzenet panelen
- Mentsd el a JSON fájlt
- Oszd meg a csapattal a hibakereséshez
- Tesztelj korán és gyakran – Használd az Inspektort fejlesztés közben, ne csak hibák esetén
- Kezdd egyszerűen – Először teszteld az alap hálózati kapcsolatot, aztán az összetett eszköz hívásokat
- Ellenőrizd a sémát – Sok hiba paramétertípus hibákból ered
- Olvasd el a hibaüzeneteket – Az MCP hibák általában leíró jellegűek
- Tartsd nyitva az Inspektort – Segít azonnal észrevenni a fejlesztés közbeni problémákat
Befejezted a 3. modult: Kezdetek! Folytasd a tanulást:
Jogi nyilatkozat: Ezt a dokumentumot az AI fordító szolgáltatás, a Co-op Translator segítségével fordítottuk. Bár az pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum anyanyelvén tekintendő hiteles forrásnak. Kritikus információk esetén professzionális, emberi fordítást ajánlunk. Nem vállalunk felelősséget a fordítás használatából eredő félreértésekért vagy téves értelmezésekért.