Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- software:vyvoj:mcp-inspector-zakladni-spusteni [2026/03/07 12:23] – Zalozeni clanku o MCP Inspectoru do sekce vyvoje Petr Nosek
+++ software:vyvoj:mcp-inspector-zakladni-spusteni [2026/03/09 05:35] (aktuální) – Doplnění workaroundu s /health pro aktivaci proxy v Dockeru Petr Nosek
@@ Řádek 6: / Řádek 6: @@
 Z oficiální dokumentace jsem si ověřil, že jde o nástroj pro testování a debugging MCP serverů. Prakticky kombinuje webové rozhraní pro interaktivní práci a proxy vrstvu, která se stará o připojení k MCP serverům.
 ===== Co je MCP Inspector =====
@@ Řádek 12: / Řádek 13: @@
 Základní výhoda je v tom, že dostanu přehledné UI a nemusím si psát vlastní pomocné skripty jen kvůli testování. Oficiální projekt je dostupný na GitHubu: https://github.com/modelcontextprotocol/inspector.
+===== Ukázka jak s MCP Inspectorem pracovat =====
+Vycházel jsem z tohoto zdroje: https://www.dokuwiki.org/plugin:mcp
+Samotný print screen napoví:
+{{.:pasted:20260307-125542.png}}
 ===== Klíčové Kroky =====
@@ Řádek 30: / Řádek 40: @@
 Ukázalo se, že v mém prostředí nebyl na hostitelském počítači povolený port ''%%6277%%''. Dokud jsem tento port neotevřel na firewallu, Inspector se k MCP serverům nepřipojil tak, jak jsem potřeboval.
+V Dockeru jsem ale navíc zjistil ještě jednu zvláštnost: po spuštění Inspectoru jsem musel nejdříve zavolat endpoint ''%%/health%%'', aby se proxy server skutečně "aktivoval":
+<code bash>
+curl http://127.0.0.1:6277/health
+</code>
+Zatím jsem nepřišel na to, proč je to potřeba a jak to rozumně zjednodušit. Beru to zatím jako workaround. Důležité je, že tento krok nepomáhal na hostitelském počítači - volání muselo proběhnout uvnitř Dockeru. Jakmile jsem to udělal v Dockeru, začalo to následně fungovat i na hostitelském počítači.
 ==== Oprava na firewallu ====
@@ Řádek 47: / Řádek 65: @@
   * **UI port:** ''%%6274%%''
   * **Proxy port:** ''%%6277%%''
+  * **Aktivace proxy v Dockeru:** ''%%curl http://127.0.0.1:6277/health%%''
   * **Firewall pravidlo:** ''%%ufw allow in on docker0 to any port 6277 proto tcp%%''
-V mém případě bylo kritické si uvědomit, že samotné spuštění Inspectoru ještě neznamená funkční síťovou komunikaci směrem k MCP serverům. Rozhodující bylo povolení správného portu na hostitelském firewallu.
+V mém případě bylo kritické si uvědomit, že samotné spuštění Inspectoru ještě neznamená funkční síťovou komunikaci směrem k MCP serverům. Rozhodující bylo povolení správného portu na hostitelském firewallu a v Dockeru navíc ruční aktivace proxy přes ''%%/health%%''.
 ===== Praktický Postup, Který Mi Fungoval =====
 Nejprve jsem spustil Inspector příkazem ''%%npx @modelcontextprotocol/inspector%%''. Následně jsem ověřil, že problém není ve startu aplikace, ale v navázání spojení k MCP serverům.
+Pokud Inspector běžel v Dockeru, zavolal jsem uvnitř kontejneru ještě:
+<code bash>
+curl http://127.0.0.1:6277/health
+</code>
+Teprve potom se proxy server korektně aktivoval. Samotné zavolání stejného endpointu na hostitelském počítači mi nepomohlo.
 Potom jsem na hostitelském stroji přidal UFW pravidlo pro port ''%%6277%%'' na rozhraní ''%%docker0%%'':
@@ Řádek 65: / Řádek 92: @@
 ===== Závěr / Výstupy =====
-MCP Inspector mi posloužil jako jednoduchý nástroj pro základní testování a debugging MCP serverů. V mém nasazení nebyl problém v samotném nástroji, ale v tom, že bylo potřeba explicitně povolit port ''%%6277%%'' na firewallu hostitelského počítače.
+MCP Inspector mi posloužil jako jednoduchý nástroj pro základní testování a debugging MCP serverů. V mém nasazení nebyl problém jen v samotném nástroji, ale i v tom, že bylo potřeba explicitně povolit port ''%%6277%%'' na firewallu hostitelského počítače a v Dockeru ručně aktivovat proxy voláním ''%%curl http://127.0.0.1:6277/health%%''. Zatím to beru jako praktický workaround, protože přesný důvod tohoto chování jsem ještě nedohledal.