Skip to main content
Glama
gn-tracing-mcp

gn-tracing-mcp

Official
by gnasdev

GN Tracing OSS

Open-source companion to GN Tracing — a browser extension that records a tab (video, console, network, WebSocket) into a shareable replay.

This repo carries the parts of the project that are useful on their own:

Path

What it is

mcp/

gn-tracing-mcp — MCP server that lets a coding agent read a replay link or a gn-tracing-*.zip package: console errors with source-mapped stacks, failed requests, and the user timeline.

packages/replay-core/

@gn-tracing/replay-core — runtime-agnostic parser for recording packages (zip reader, artifact models, agent summary, query, report).

src/shared/

Shared helpers the replay-core tests compare against, synced from the main repo.

Quick start

cd mcp
npm ci
npm run build   # → dist/gn-tracing-mcp.mjs

Wire node dist/gn-tracing-mcp.mjs into your MCP client — details in mcp/README.md.

Related MCP server: FlowLens MCP

Tests

npm install     # root dev deps (vitest)
npm test

Tasks

Task wraps the same commands:

task install     # npm ci for the root and mcp/
task check       # typecheck + tests + MCP bundle, in one go
task test        # vitest only
task build       # mcp/dist/gn-tracing-mcp.mjs
task dev         # rebuild the MCP bundle on every source change

License

GPL-3.0-or-later. See LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables coding agents to access recorded browser flows (user actions, network, console, etc.) for debugging and regression testing without reproducing issues.
      109
      Apache 2.0
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables coding agents to inspect recorded browser flows—including user actions, network activity, console output, storage, DOM events, and screen recordings—for debugging, bug reporting, and regression testing without reproducing the issue.
      -