MCP Inspector: základní přehled a spuštění v mém prostředí

Potřeboval jsem rychle otestovat a ladit MCP servery přes grafické rozhraní místo ručního posílání požadavků. Pro tento účel jsem použil projekt MCP Inspector: https://github.com/modelcontextprotocol/inspector.

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.

MCP Inspector používám jako vývojářský nástroj pro rychlou kontrolu toho, zda se MCP server spustí, zpřístupní nástroje a vrací očekávané odpovědi. Hodí se ve chvíli, kdy potřebuji ověřit konfiguraci serveru, zkontrolovat komunikaci nebo reprodukovat problém mimo konkrétního MCP klienta.

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.

Inspector jsem spustil tímto příkazem:

npx @modelcontextprotocol/inspector

Podle projektu tím standardně naběhne klientské rozhraní na portu 6274 a proxy server na portu 6277. Právě port 6277 byl v mém prostředí důležitý pro samotné připojení k MCP serverům.

Po spuštění jsem narazil na problém, kdy se Inspector nedařilo korektně připojit k MCP serverům. Samotné spuštění proběhlo, ale komunikace nefungovala správně.

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.

Pomohlo mi povolit příchozí TCP provoz na port 6277 pro rozhraní docker0:

ufw allow in on docker0 to any port 6277 proto tcp

Po přidání tohoto pravidla začalo spojení fungovat správně.

• Projekt: https://github.com/modelcontextprotocol/inspector
• Start příkaz: npx @modelcontextprotocol/inspector
• UI port: 6274
• Proxy port: 6277
• 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.

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.

Potom jsem na hostitelském stroji přidal UFW pravidlo pro port 6277 na rozhraní docker0:

ufw allow in on docker0 to any port 6277 proto tcp

Po této změně už Inspector fungoval správně a připojení k MCP serverům bylo v pořádku.

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.