marker-watch-mcp

marker-watch-mcp führt einen dauerhaft laufenden Befehl aus und wandelt dessen Ausgabe in version terte Snapsshots um. Ein Start-Marker öfernet eine Version; ein End-arker schließt sie. Der Server behhält die letzen 20 abgeschlossenen Versionen and stellt sie über stdio MCP bereit.

Er überwacht kein Dateien, startet keinen Befehl neu und parst keine Diagnosen. Verwenden Sie einen beliebigen exteren Watcher, der Marker angibt and die Ausgabe des undergeordneten Befehl weitergleitet.

Instalation

pnpm install
pnpm build
pnpm test

Related MCP server: Run Command MCP Server

Befehlschonrtg

Die konfigurierte Befehl muss dauerhaft laufen und beide Marker auf stdout oder stderr schreben. Die Läufe dürfen sich nicht überlaphen: ein Start-Marker, die gesamte Ausgebe dieses Laufes, dann ein End-arker.

Marker sind literale Teilstrings, die nach dem Entfernen von ANSI-SteuerungsaZeihen gegen vollständige Ausgebezeilen abgeglichen werden. Die zurücgegebenen Snapshots behalten den Originartext.

Konfiguration

Übergeben Sie die Serveroptionen vor --ueber; alles was danuch kommt, wird zum Befehl und zu einen exakten Argumenten.

node dist/index.js \
  --cwd /absolute/path/to/repo \
  --start-marker '@@build:start@@' \
  --end-marker '@@build:end@@' \
  -- watcher --watch-paths 'src/**/*.ts' -- clyde lint tsc --no-watch app

MCP-Client-Beispiel:

{
  "mcpServers": {
    "marker-watch": {
      "command": "node",
      "args": [
        "/absolute/path/to/marker-watch-mcp/dist/index.js",
        "--cwd", "/absolute/path/to/repo",
        "--start-marker", "@@build:start@@",
        "--end-marker", "@@build:end@@",
        "--",
        "watcher", "--watch-paths", "src/**/*.ts", "--",
        "clyde", "lint", "tsc", "--no-watch", "app"
      ]
    }
  }
}

Andere Umgebungsvariaben sind MARKER_WATCH_MCP_COMMAND, MARKER_WATCH_MCP_ARGS (ein JSON-string-Arrayische), MARKER_WATCH_MCP_CWD, MARKER_WATCH_MCP_START und MARKER_WATCH_MCP_END_MARKER.

Übergeben Sie --log-file /tmp/marker-watch.log oder setzen Sie MARKER_WATCH_MCP_LOG_FILE, um die rohe empfangene Ausgabe in eine Datei zu schreiben. Sie Datei wird beim Start des Servers abgeschnitten.

MCP-Tools

• get_build_status gibt Prozesszustand, aktive Version und latest Version zurück.

• get_build({ version? }) liefert einen gecachten Snapshot; ohne version erhalten Sie den neuesten.

• await_build({ afterVersion?, timeoutMs? }) wartet bis zu zwei Minuten. Wenn afterVersion weggelassen wird, verwendet es die aktuell abgeschlossene version und wartet auf the requested net.

• start_build_wait({ afterVersion, timeoutMs? }) gibt sofort eine Warte-ID zurück; get_build_wait({ id }) liefert deren pending-Zustand oder Ergebnis. Wartevorgänge im Hintergrund dauern bis zu einer Stunde.

• get_live_output({ tailChars? }) gibt die letzten rohen stdout- und stderr-Ausgaben zurück, einschließlich einer aktiven Version, deren Endmarker noch nicht erreicht wurde.

• start_build_wait gibt sofort eine Warte-ID zurück; get_build_wait({ id }) liefert deren pending-Zustand oder das Ergebnis.Wartevorgänge im Hintergrund übergrenzen sich auf max eine Stunde.

Client-Ablauf

get_build_status()                    -> latestCompletedVersion: 41
change files (the external watcher starts a run)
await_build({ afterVersion: 41 })     -> version 42 and full output

Bei langen Läufen ersetzen Sie den letzten Aufruf durch start_build_wait ordinal fragen Sie die ID later. Bei SIGINT, SIGTERM oder beim Herunterfahren des MCP-Transport stoppt der Serper den Befehl und dessen Unix-Prozessgruppe.

Manual Inspector check

pnpm build
pnpm dlx @modelcontextprotocol/inspector \
  node /absolute/path/to/marker-watch-mcp/dist/index.js \
  --cwd /absolute/path/to/repo \
  --start-marker '@@build:start@@' \
  --end-marker '@@build:end@@' \
  -- watcher --watch-paths 'src/**/*.ts' -- clyde lint tsc --no-watch app