Runtime Profile mit MCP Inspector prüfen

Mit MCP Inspector trennst du Probleme im Runtime Profile oder Server von Problemen im AI-Client. LightNow erzeugt einen kleinen ausführbaren Wrapper; Inspector startet ihn als stdio-MCP-Server und nutzt denselben Runtime-Kontext wie lightnow run.

Was dieser Test abdeckt

Grenze	Was ein Erfolg belegt
Profil-Export	Das Profil enthält einen Registry-verknüpften, Runner-kompatiblen Server.
Runtime-Bereitschaft	Benötigte Konfiguration und Secrets lassen sich im gewählten Kontext auflösen.
Serverstart	Command, Paket, Environment und Arbeitsverzeichnis funktionieren.
MCP-Discovery	Der Server beantwortet einen echten tools/list-Request.

Dies ist ein fokussierter Runner-Test und kein LightNow-Proxy-Modus. AI-Clients im täglichen Einsatz sollten weiterhin über LightNow Proxy verbunden werden.

1. Wrapper erzeugen

Ausführbaren Inspector-Wrapper erstellen

lightnow sync --client mcp-inspector --runner --profile default --config-path ./lightnow-mcp-inspector.sh

Das Profil muss mindestens einen Registry-verknüpften Server mit Alias und Version enthalten. Der erzeugte Shell-Wrapper verwendet den ersten Runner-kompatiblen Server. Nutze ein fokussiertes Profil, wenn du einen bestimmten Upstream testen möchtest.

Der Wrapper hat diese Form:

lightnow-mcp-inspector.sh

#!/usr/bin/env sh
exec lightnow 'run' '--profile' 'default' '--server' 'sonarqube' "$@"

Bei einer ausgewählten Organisation ergänzt LightNow das Tenant-Argument. lightnow run fordert den autorisierten stdio-Runtime-Kontext an, löst Secrets für den lokalen Runner auf und stoppt bei fehlenden Pflichtwerten vor dem Serverstart.

2. Inspector öffnen

Inspector-UI starten

npx @modelcontextprotocol/inspector ./lightnow-mcp-inspector.sh

Öffne die von Inspector ausgegebene lokale URL. Verbinde dich mit dem generierten stdio-Server, führe tools/list aus, prüfe die Tool-Schemas und rufe anschließend ein kleines, nur lesendes Tool auf.

Für einen wiederholbaren Kommandozeilen-Check bietet Inspector einen CLI-Modus:

Tools ohne Browser-UI auflisten

npx @modelcontextprotocol/inspector --cli ./lightnow-mcp-inspector.sh --method tools/list

Die Befehlsform entspricht der offiziellen MCP-Inspector-Dokumentation.

3. Fehlergrenze bestimmen

Fehler	Verantwortliche Grenze	Nächste Aktion
Wrapper-Erzeugung scheitert	Runtime Profile	Ergänze einen verknüpften Server mit Alias und Version oder wähle Profil und Kontext korrekt.
Runner stoppt vor dem Serverstart	Runtime-Konfiguration	Ergänze benötigte Konfiguration oder Secrets für diesen Profilserver.
tools/list scheitert	Upstream-Runtime	Prüfe Executable, Paket, Environment, Authentifizierung, TLS und Server-Logs.
Inspector funktioniert, der AI-Client aber nicht	Client oder LightNow Proxy	Prüfe Client-Status, Proxy-Config, Neustart und Tool-Cache.

Erweitere die Untersuchung erst, wenn feststeht, welche Zeile fehlschlägt. Ein funktionierender Inspector belegt, dass sich der Profilserver wie ein normaler stdio-MCP-Server verhält; er belegt nicht, dass die generierte Konfiguration eines anderen Clients aktuell ist.

Inspector lokal halten

Verwende die von Inspector ausgegebene authentifizierte lokale URL. Deaktiviere die Authentifizierung nicht und veröffentliche die Ports nicht in einem nicht vertrauenswürdigen Netzwerk.

Fahre mit LightNow Proxy debuggen fort, wenn Inspector funktioniert, ein verwalteter Client aber scheitert. Nutze Runtime-Secrets und Konfiguration, wenn der Runner fehlende Inputs meldet, und Runtime-Events für Request-Evidenz aus einer echten Client-Session.