Skip to content

Commit 5fcaaeb

Browse files
docs: four-mode UI with phased launch strategy
Phase 1 (launch): Explorer + Debugger, no LLM key needed. Phase 2 (after launch): Agent + Tracer, require LLM config. Each mode feeds the next in a natural adoption funnel.
1 parent 929a192 commit 5fcaaeb

1 file changed

Lines changed: 12 additions & 4 deletions

File tree

docs/roadmap.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,13 +30,21 @@ mcp-assert ui --server "npx my-server" --port 7890
3030
└─────────────────────────────────┘
3131
```
3232

33-
### Three modes
33+
### Four modes (two phases)
3434

35-
**Explorer**: Connect to any MCP server. See all tools, prompts, resources in a tree. Click a tool to see its JSON Schema. Click "Call" to invoke with editable args. Response displayed with syntax highlighting. Interactive version of the audit command.
35+
**Phase 1 (launch)**: Explorer + Debugger. Self-contained, no LLM key needed, demonstrates core value.
3636

37-
**Tracer**: Proxies between agent and server (builds on `intercept`). Every tool call appears in a live timeline via WebSocket. Click to expand: request args, response body, duration, isError. Filter by tool name, status, duration. Export session as trajectory YAML for regression testing.
37+
**Explorer**: Connect to any MCP server. See all tools, prompts, resources in a tree. Click a tool to see its JSON Schema. Click "Call" to invoke with editable args. Response displayed with syntax highlighting. "Save as assertion" button turns any call into a YAML test case. Interactive version of the audit command.
3838

39-
**Debugger**: Run a suite from the UI. Failures appear in a list. Click a failure: see request, actual response, expected values, specific expectation that failed. Side-by-side diff view. "Fix" button suggests YAML edits (visual version of `--fix` mode).
39+
**Debugger**: Run a suite from the UI. Failures appear in a list. Click a failure: see request, actual response, expected values, specific expectation that failed. Side-by-side diff view. "Fix" button suggests YAML edits (visual version of `--fix` mode). "Export suite" generates YAML + GitHub Actions workflow.
40+
41+
**Phase 2 (after launch)**: Agent + Tracer. Require LLM config and WebSocket proxy infrastructure.
42+
43+
**Agent**: Connect an LLM (OpenAI, Anthropic, etc.), let it drive the server's tools via ReAct loop. Watch the tool call chain in real time. Tool confirmation mode (approve/deny before execution). Record the full session as a trajectory YAML for CI regression testing. This is ProtoMCP's agent mode plus assertions.
44+
45+
**Tracer**: Proxy between an external agent (Claude Code, Cursor, etc.) and an MCP server. Every tool call appears in a live timeline via WebSocket. Click to expand: request args, response body, duration, isError. Filter by tool name, status, duration. Export session as trajectory YAML. Builds on the existing `intercept` command.
46+
47+
**The funnel**: Explorer ("does my server work?") leads to Debugger ("why did this fail?") leads to Agent ("how does an LLM use my tools?") leads to Tracer ("what is my production agent doing?"). Each mode feeds the next.
4048

4149
### Frontend stack
4250

0 commit comments

Comments
 (0)