marker-watch-mcp

marker-watch-mcp は、長時間動作し続ける1つのコマンドを起動し、その出力をバージョン付きスナップショットに変換します。開始マーカーが1つのバージョンを開始し、終了マーカーがそれを閉じます。サーバーは完了した直近20バージョンを保持し、それらを stdio MCP 経由で公開します。

ファイルの監視、コマンドの再起動、診断の解析は行いません。マーカーを出力し、子コマンドの出力を転送する外部ウォッチャーを利用してください。

インストール

pnpm install
pnpm build
pnpm test

Related MCP server: Run Command MCP Server

コマンド契約

設定したコマンドは実行し続け、両方のマーカーを stdout または stderr に書き出さなければなりません。実行が重なってはなりません。1つの開始マーカー、その実行のすべての出力、そして1つの終了マーカー、という順序です。

マーカーは、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_build_wait({ afterVersion, timeoutMs? }) は待機 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