Skip to content

V2 Spec Additions - #945

Merged
olaservo merged 8 commits into
modelcontextprotocol:v2/mainfrom
olaservo:v2/feature/tech-stack-votes
Dec 10, 2025
Merged

V2 Spec Additions#945
olaservo merged 8 commits into
modelcontextprotocol:v2/mainfrom
olaservo:v2/feature/tech-stack-votes

Conversation

@olaservo

@olaservoolaservo commented Nov 30, 2025•
edited
Loading

Copy link
Copy Markdown
Member

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.

olaservoand 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

@cliffhallcliffhall left a comment

Copy link
Copy Markdown
Member

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.

Comment threadspecification/v2_ux.md Outdated
Comment threadspecification/v2_ux.md Outdated
Comment threadspecification/v2_ux.md Outdated
Comment threadspecification/v2_ux.md Outdated
Comment threadspecification/v2_ux.md
Comment threadspecification/v2_ux.md Outdated
Comment threadspecification/v2_ux.md Outdated
Comment threadspecification/v2_ux.md Outdated
Comment threadspecification/v2_ux.md
Comment threadspecification/v2_ux.md Outdated
cliffhall
cliffhall reviewed Dec 2, 2025
View reviewed changes
Comment threadspecification/v2_ux.md Outdated
cliffhall

This comment was marked as outdated.

Sign in to view

pcarleton
pcarleton reviewed Dec 3, 2025
View reviewed changes
Comment threadspecification/v2_tech_stack.md Outdated
pcarleton
pcarleton reviewed Dec 3, 2025
View reviewed changes
Comment threadspecification/v2_ux.md
olaservoand 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
Comment threadspecification/v2_ux.md
@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 PRmodelcontextprotocol#945feedback
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/mainDec 10, 2025
olaservo added a commit to olaservo/inspector that referenced this pull request Dec 25, 2025
@olaservo@claude
Add Mantine prototype with full navigation shell
fd59a91
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
olaservo deleted the v2/feature/tech-stack-votes branch January 19, 2026 14:42
@olaservoolaservo mentioned this pull request Jan 19, 2026
Closed
@cliffhallcliffhall added the v2 Issues and PRs for v2 label Apr 16, 2026
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@KKonstantinovKKonstantinovKKonstantinov left review comments
@pcarletonpcarletonpcarleton left review comments
@cliffhallcliffhallcliffhall requested changes
@mattzcareymattzcareymattzcarey left review comments

Assignees

@olaservoolaservo

Labels

v2Issues and PRs for v2

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@olaservo@KKonstantinov@pcarleton@cliffhall@mattzcarey