Skip to content

V2 Spec Additions #945

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
olaservo merged 8 commits into from
Dec 10, 2025
Merged

V2 Spec Additions #945

olaservo merged 8 commits into from
Dec 10, 2025
+1,506 −5

Conversation

@olaservo
Copy link
Member

@olaservo olaservo commented Nov 30, 2025 •
edited
Loading

Fixes: #947

Changes:

  • Adds a spec file for UX
  • Adds my takes on which tech to use for http and logging

Methodology:

  • Used Claude Opus 4.5 to analyze MCPJam source and latest MCP spec schema to propose UX and features to add to current spec files
  • Started grabbing a few feature requests ad-hoc from current inspector issues that seem like they should be included (such as support for official registry server.json)

Other notes:

  • I think it would be ideal to get something interactive going early, so I am generating a couple simple prototypes to get a feel for what the code would actually look like and how it might work in practice. Will post those in the discord and latest WG discussion thread.
  • If that method works well, we can let claude [or insert your fav bot here] to pick and choose what we like from those examples and use that to iterate on the spec.

olaservo and others added 3 commits November 29, 2025 21:18
@olaservo @claude
Vote for Express and Pino in tech stack decisions
dfb0f14 
- Express: cleaner routing/middleware for proxy CRUD endpoints, well-maintained ecosystem
- Pino: fastest logger option, JSON-structured logs work well for debugging MCP traffic

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@olaservo @claude
Add v2_ux.md specification with detailed UX patterns
8fec93f 
Based on MCPJam Inspector analysis:
- Server connection card with status indicators
- Resizable panel layouts for Tools/Resources/Prompts screens
- Form generation from JSON Schema
- Error handling patterns (inline errors, retry count, doc links)

Also updates nav links in all spec files to include v2_ux.md.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@olaservo @claude
Add full MCP 2025-11-25 protocol coverage to v2_ux.md
79b5e9f 
- Add server.json import support (Issue modelcontextprotocol#922) for MCP Registry format
- Add History Screen with automatic capture and replay functionality
- Add Pino logging rationale with log-as-history architecture
- Remove emojis from markdown files, use text alternatives

New UX sections added:
- Logging Screen (notifications/message, logging/setLevel)
- Tasks Screen (tasks/*, notifications/task/statusChanged)
- Sampling Panel (sampling/createMessage)
- Elicitation Handler (form + URL modes)
- Roots Configuration (roots/list)
- Experimental Features Panel (raw JSON-RPC tester)

Enhanced existing screens:
- Tools: annotations, autocomplete, progress indicators, image/audio
- Resources: annotations, subscriptions
- Prompts: autocomplete
- Navigation: ping latency, listChanged indicators

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
olaservo added a commit to olaservo/inspector that referenced this pull request Nov 30, 2025
@olaservo @claude
Add Mantine prototype with full navigation shell
0c054a5 
Implements UI-only prototype for component library evaluation:

- Server List home page with server cards
- AppLayout with top navigation (Tools, Resources, Prompts, Logs, Tasks, History)
- All 7 screen stubs with mock data
- ServerCard and StatusIndicator components
- Dark theme with Mantine v7

Based on v2_ux.md specification from PR modelcontextprotocol#945.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
olaservo added a commit to olaservo/inspector that referenced this pull request Nov 30, 2025
@olaservo @claude
Add Shadcn prototype with full navigation shell
80bd087 
Implements UI-only prototype for component library evaluation:

- Server List home page with server cards
- AppLayout with top navigation (Tools, Resources, Prompts, Logs, Tasks, History)
- All 7 screen stubs with mock data
- ServerCard and StatusIndicator components
- Shadcn UI components (Button, Card, Badge, Switch, Input, Select)
- Tailwind CSS dark theme

Based on v2_ux.md specification from PR modelcontextprotocol#945.
Mirror of Mantine prototype for comparison.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
cliffhall
cliffhall requested changes Dec 2, 2025
View reviewed changes
Copy link
Member

@cliffhall cliffhall left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for all this great work, @olaservo. I added a few thoughts.

cliffhall
cliffhall reviewed Dec 2, 2025
View reviewed changes
cliffhall

This comment was marked as outdated.

Sign in to view

pcarleton
pcarleton reviewed Dec 3, 2025
View reviewed changes
pcarleton
pcarleton reviewed Dec 3, 2025
View reviewed changes
olaservo and others added 3 commits December 7, 2025 21:06
@olaservo @claude
docs: revise v2 specs based on PR feedback
b66b674 
Address reviewer feedback from cliffhall, pcarleton, KKonstantinov, mattzcarey:

v2_ux.md changes:
- Add Server Settings Modal for per-server config (headers, metadata, timeouts, OAuth)
- Add Clone button to Server Card Actions
- Add OAuth Debugger section for debugging auth flows
- Change Resources Screen from resizable panes to accordion pattern
- Update Logging Screen to all 8 RFC 5424 levels with distinct colors
- Clarify Browse button as local file picker
- Expand JSON-RPC Tester to support all methods with custom headers
- Add multi-select support for anyOf/oneOf enums in Form Generation

v2_tech_stack.md changes:
- Select Hono over Express based on community consensus
- Add Hono Rationale section with comparison table

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@olaservo @claude
docs: add OAuth Debug button to Card Actions list
1d8254c 
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@olaservo @claude
docs: update Server Card ASCII art with all buttons
5eaddd1 
- Add [Settings], [Clone] buttons to card
- Add separate OAuth example showing [OAuth Debug] button
- Widen card to fit all buttons

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
olaservo
olaservo commented Dec 8, 2025
View reviewed changes
@olaservo @claude
docs: add per-tool metadata feature to Tools Screen
ecccbb0 
Address cliffhall's feedback about tool-specific metadata:
- Add [Edit Metadata] button for per-tool _meta fields
- Stored per-server, per-tool (not in global localStorage)
- Merged with server-level metadata on each call

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
olaservo added a commit to olaservo/inspector that referenced this pull request Dec 8, 2025
@olaservo
Merge v2/feature/tech-stack-votes into v2/feature/prototype
d059d24 
Brings in PR modelcontextprotocol#945 feedback revisions:
- Server Settings Modal spec
- OAuth Debugger spec
- Resources accordion pattern
- 8 RFC 5424 log levels
- Hono selected over Express
- Advanced JSON-RPC tester spec
olaservo added a commit to olaservo/inspector that referenced this pull request Dec 8, 2025
@olaservo @claude
docs: revise v2 specs based on PR modelcontextprotocol#945 feedback
c1c6710 
Address reviewer feedback from cliffhall, pcarleton, KKonstantinov, mattzcarey:

Spec changes (v2_ux.md):
- Add Server Settings Modal for per-server config (headers, metadata, timeouts, OAuth)
- Add Clone button to Server Card Actions
- Add OAuth Debugger section for debugging auth flows
- Change Resources Screen from resizable panes to accordion pattern
- Update Logging Screen to all 8 RFC 5424 levels with distinct colors
- Clarify Browse button as local file picker
- Expand JSON-RPC Tester to support all methods with custom headers
- Add multi-select support for anyOf/oneOf enums in Form Generation

Tech stack changes (v2_tech_stack.md):
- Select Hono over Express based on community consensus
- Add Hono Rationale section with comparison table

Prototype changes (shadcn branch):
- Resources.tsx: Implement accordion pattern with collapsible sections
- Logs.tsx: Add all 8 RFC 5424 levels with distinct color styles

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@olaservo @claude
docs(spec): Add Connection Mode dropdown to ServerCard wireframes
a13a05d 
Update UX spec to show inline Connection Mode dropdown on ServerCard
for quick switching between Direct and Via Proxy modes.

Based on Cliff's feedback about making connection type more accessible
rather than buried in Settings modal.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@olaservo olaservo merged commit 39976a4 into modelcontextprotocol:v2/main Dec 10, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@KKonstantinov KKonstantinov KKonstantinov left review comments

@pcarleton pcarleton pcarleton left review comments

@cliffhall cliffhall cliffhall requested changes

@mattzcarey mattzcarey mattzcarey left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@olaservo @KKonstantinov @pcarleton @cliffhall @mattzcarey