marker-watch-mcp

marker-watch-mcp выполняет одну долгоживущую команду и превращает ею вывод в версиионные снepшоты. Стартовый маркер начинаvert версию; завершающий маркер закрыvert ею. Сервере храниет последние 20 завершённых версий и предоставляет их через stdio MCP.

Он не следит за файлами, не перезапускает команды и не разбирает дианостику. Ипользуйте любой внешний наблюдцатель, который испускает маркеры и передаёт вывод своуей дочерiejу команды.

Install

pnpm install
pnpm build
pnpm test

Related MCP server: Run Command MCP Server

Command contract

Настроенная команда должна оставатьтся заппущенной and писаться писать both markers in stdout or stderr. Runs не должны переквативаться: one start marker, весь вывод for this run, then one end marker.

Markers — это литерalные подстроки, сопоставляемые с полنыми строками выода после удаления management последовтельностей ANSI. Возвращемые снапшоты сохраняют исhodنый текст.

Configuration

Передавайте параметры сервера до --; всё, что после него, becomes the command and her exact argументы.

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 пример:

{
  "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"
      ]
    }
  }
}

Альтернативы через переменные окружения: MARKER_WATCH_MCP_COMMAND, MARKER_WATCH_MCP_ARGS (JSON-array of strok), MARKER_WATCH_MCP_CWD, MARKER_WATCH_MCP_START_MARKER and MARKER_WATCH_MCP_END_MARKER.

Переейте --log-file /TMP/marker-watch.log or set MARKER_WATCH_MCP_LOG_FILE to write raw received output to file. Файл обрезается at start of server.

ANotes MCP tools

• get_build_status returns process state, active version and latest version.

• get_build({ version? }) returns a cached snapshot; omit version for the latest.

• await_build({ afterVersion?, timeoutMs? }) waits up to two minutes. If afterVersion omitted, uses current completed version and waits for next.

• start_build_wait({ afterVersion, timeoutMs? }) immediately returns wait id; get_build_wait({ id }) returns its state pending or result. Background waits last up to one hour.

• get_live_output({ tailChars? }) returns recent raw stdout and stderr, including active version that has not yet reached its end marker.

Client flow

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

For long runs, replace the final call with start_build_wait, then later ask its ID. On SIGINT, SIGTERM or MCP transport shutdown, the server stops the command and its Unix process group.

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