marker-watch-mcp

marker-watch-mcp는 하나의 장기 실행 명령을 실행하고 그 출력을 버전별 스냅샷으로 변환합니다. 시작 마커는 버전을 열고, 종료 마커는 버전을 닫습니다. 서버는 마지막 20개의 완료된 버전을 유지하며 stdio MCP를 통해 노출합니다.

파일을 감시하지 않고, 명령을 재시작하지 않으며, 진단 정보를 파싱하지 않습니다. 마커를 내보내고 자식 명령의 출력을 전달하는 외부 와처를 사용하세요.

설치

pnpm install
pnpm build
pnpm test

Related MCP server: Run Command MCP Server

명령 계약

구성된 명령은 계속 실행되면서 stdout 또는 stderr에 두 마커를 모두 기록해야 합니다. 실행이 겹치면 안 됩니다. 시작 마커 하나, 해당 실행의 모든 출력, 그다음 종료 마커 하나로 구성됩니다.

마커는 ANSI 제어 시퀀스가 제거된 완전한 출력 라인과 대조되는 리터럴 부분 문자열입니다. 반환되는 스냅샷은 원본 텍스트를 그대로 유지합니다.

설정

-- 앞에 서버 옵션을 전달하세요. -- 뒤의 모든 내용은 명령과 그 정확한 인수가 됩니다.

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 클라이언트 예시:

{
  "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 문자열 배열), MARKER_WATCH_MCP_CWD, MARKER_WATCH_MCP_START_MARKER, MARKER_WATCH_MCP_END_MARKER가 있습니다.

수신한 원본 출력을 파일에 기록하려면 --log-file /tmp/marker-watch.log를 전달하거나 MARKER_WATCH_MCP_LOG_FILE을 설정하세요. 파일은 서버가 시작될 때 잘립니다.

MCP 도구

• get_build_status는 프로세스 상태, 활성 버전, 최신 버전을 반환합니다.

• get_build({ version? })는 캐시된 스냅샷을 반환합니다. version을 생략하면 최신 버전을 반환합니다.

• await_build({ afterVersion?, timeoutMs? })는 최대 2분까지 대기합니다. afterVersion을 생략하면 현재 완료된 버전을 사용하여 다음 버전을 기다립니다.

• start_국를 ID를대기 ID를 즉시 반환하며,get_build_wait({ id })는 해당 pending` 상태 또는 결과를 반환합니다. 백그라운드 대기는 최대 1시간까지 유지됩니다.

• get_live_output({ tailChars? })는 아직 종료 마커까지 도달하지 않은 활성 버전을 포함하여 최근 원본 stdout과 stderr를 반환합니다.

클라이언트 흐름

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

긴 실행의 경우 start_build_wait으로 마지막 호출을 대체하고, 나중에 해당 ID를 조회하세요. SIGINT, SIGTERM, 또는 MCP 전송 종료 시 서버는 명령과 해당 Unix 프로세스 그룹을 중지합니다.

수동 Inspector 확인

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