Commit graph

1,898 commits

Author SHA1 Message Date
cliffhall
707cb19b2f update main.yml 2026-03-17 16:48:32 -04:00
cliffhall
4b28a69856 formatting 2026-03-17 16:43:27 -04:00
cliffhall
0471443716 fix: Use ServerListScreen with real ServerCards in HomeLayout stories
Replace placeholder Paper elements with actual ServerListScreen organism
containing properly configured ServerCard components.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 11:54:09 -04:00
cliffhall
d53c3d338f feat: Add HomeLayout and ConnectedLayout components with Storybook stories
- HomeLayout: AppShell with header (title + theme toggle) for disconnected state
- ConnectedLayout: AppShell with server name, status indicator, tab navigation,
  theme toggle, and disconnect button for connected state

All 6 phases of the Storybook component plan are now complete:
12 atoms, 25 molecules, 7 organisms, 2 layouts = 46 components total

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 10:47:52 -04:00
cliffhall
019e10429d * Added AGENTS.md 2026-03-17 10:43:56 -04:00
cliffhall
75f6f6452a feat: Add 7 organism screen components with Storybook stories
- ServerListScreen: Home page with server card grid and add server menu
- ToolsScreen: Three-panel layout (tool list, detail/form, results)
- ResourcesScreen: Two-panel with accordion sections and content preview
- PromptsScreen: Two-panel with prompt selection and message display
- LoggingScreen: Two-panel with log controls and real-time log stream
- TasksScreen: Active and completed task card sections
- HistoryScreen: Request history with search, filter, and pinned entries

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 10:27:50 -04:00
cliffhall
39ef184b53 feat: Add Mantine theme, 12 atom components, and 25 molecule components with Storybook stories
- Mantine theme with component extensions (Badge, Card, Paper, Button, etc.)
- CSS custom properties for design tokens (--inspector-* vars)
- Dark/light mode support with auto detection
- 12 atoms: StatusIndicator, AnnotationBadge, CapabilityItem, LogEntry,
  ProgressDisplay, ContentViewer, ListChangedIndicator, CopyButton,
  ConnectionToggle, TransportBadge, InlineError, MessageBubble
- 25 molecules: ServerCard, AddServerMenu, SchemaForm, ToolListItem,
  ToolDetailPanel, ResultPanel, ResourceListItem, ResourcePreviewPanel,
  ResourceTemplateInput, PromptArgumentsForm, PromptMessagesDisplay,
  LogControls, TaskCard, HistoryEntry, ServerInfoContent, ServerSettingsForm,
  RootsTable, SamplingRequestPanel, ElicitationFormPanel, ElicitationUrlPanel,
  InlineSamplingRequest, InlineElicitationRequest, PendingClientRequests,
  ImportServerJsonPanel, ExperimentalFeaturesPanel
- Exclude storybook-static from version control
- Exclude .stories.tsx from app tsconfig (Storybook-only modules)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 10:23:56 -04:00
cliffhall
fcd0d156f4 * Added base project to clients/web
* Added storybook build plan
2026-03-16 22:47:03 -04:00
cliffhall
b18b81bdeb spec: Add Storybook component plan with 43 components across 4 tiers
Defines all presentational components to be built in Storybook with Mantine,
organized bottom-up (atoms, molecules, organisms, layouts) with props interfaces,
Mantine implementation notes, story variations, build order, and configuration.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 22:45:05 -04:00
Ola Hungerford
285d5c085f
Apply suggestion from @olaservo 2026-03-11 08:29:10 -07:00
cliffhall
1801f557a2 * Refactored menu on spec pages
* Broke v2_tech_stack.md into v2_web_client.md, v2_server.md, and v2_storage.md
* Added v2 components with information on the presenttional components pattern.
2026-03-10 10:22:12 -04:00
Cliff Hall
78f7a1b95c
Merge pull request #1016 from olaservo/v2/spec/storage
spec: V2 Storage Specification - Zustand Proposal
2026-03-07 15:04:55 -05:00
Ola Hungerford
39d923387d
spec: Add client features UX patterns (sampling/elicitation) (#1011)
Updates UX specs for better integration of client-initiated features:

v2_ux_features.md:
- Tools Screen: Inline client request queue during tool execution
- History Screen: Hierarchical request trace showing parent-child relationships
- Logging Screen: Request correlation with correlation IDs and chain filtering

v2_ux_handlers.md:
- Sampling Panel: Inline expansion pattern + tool calling flow (2025-11-25 spec)
- Elicitation Handler: Inline expansion pattern with schema constraints
- Sampling Providers & Testing Profiles: Extensible architecture for response handlers

Key design decisions:
- Request Trace Model shows causal chains between requests
- Client requests appear inline with triggering tool calls
- Auto-response profiles enable efficient testing workflows
- Extensible provider architecture supports future LLM plugins

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

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 09:27:23 -07:00
olaservo
adc1791b25 fix(spec): simplify ExecutionFormState to use lastToolResult
Replace toolResponseHistory array with single lastToolResult field.
History is the source of truth for execution records - no need to
duplicate in UI state.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-01 12:46:41 -07:00
olaservo
d755666e76 fix(spec): correct Jotai provider claim - provider-less by default
Jotai uses provider-less mode by default since v2. Provider is only
needed for SSR, subtree isolation, or custom initial values.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 08:42:57 -07:00
olaservo
6a132d6d61 docs(spec): update storage spec diagram to match implementation
- Remove ConnectionService/ExecutionService from core interfaces
  (connection/execution state managed by React Context per spec text)
- Remove Memory implementations from core package
  (repository interfaces kept as proxy API contracts)
- Change "Handler interfaces" to "Handler functions"

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-21 08:14:38 -07:00
olaservo
2570b7a5df Fix link to mcpjam 2026-01-19 07:25:54 -07:00
olaservo
ce39e0de7c spec: Add v2 storage specification proposing Zustand
Closes #983

Proposes a hybrid state management architecture:
- Zustand for UI preferences, logs display, playground state, testing profiles
- Keep useReducer + Context for connection/execution state machines
- Repository interfaces remain storage-agnostic for proxy API integration

Includes detailed analysis of storage options (Zustand, Redux, Jotai,
Context+useReducer, TanStack Query, Valtio) with pros/cons comparison.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-19 07:17:38 -07:00
Ola Hungerford
0ec2c24cbb
Merge pull request #980 from olaservo/v2/feature/recommend-shadcn
Updating recommendation for V2 UI Components
2025-12-18 21:33:22 -07:00
olaservo
320a6c385f Remove dark mode screenshots 2025-12-18 05:08:20 -07:00
olaservo
f13095db75 Update components to use Mantine with rationale 2025-12-18 05:04:50 -07:00
olaservo
9d5110f8f4 docs(spec): Restructure UX docs and add visual reference
Break up v2_ux.md (1400+ lines) into smaller, focused documents:
- v2_ux.md - Core UX (overview, server list, modals)
- v2_ux_features.md - Feature screens (Tools, Resources, etc.)
- v2_ux_handlers.md - Client handlers, form generation, errors
- v2_screenshots.md - Visual reference with Shadcn prototype screenshots

Add screenshots from Shadcn prototype to specification/screenshots/.
Update navigation headers across all spec files.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-17 09:06:08 -07:00
olaservo
c39df75c58 docs(spec): Trim Shadcn rationale for brevity 2025-12-16 20:56:26 -07:00
olaservo
e6400ca053 docs(spec): Recommend Shadcn for V2 component library
Based on evaluation of both prototype implementations (v2/prototype/shadcn
and v2/prototype/mantine), recommend Shadcn for the following reasons:

- Component ownership: Components copied to codebase, not npm dependency
- Tailwind CSS integration: Utility-first approach with purged bundles
- Radix UI foundation: WCAG 2.1 compliant accessibility primitives
- Simpler theming: CSS variables vs React context re-renders
- Better DX: Source code visible and editable in project

Includes comparison table and tradeoffs acknowledged.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 20:47:46 -07:00
Ola Hungerford
39976a4ff9
Merge pull request #945 from olaservo/v2/feature/tech-stack-votes
V2 Spec Additions
2025-12-10 09:40:00 -07:00
olaservo
a13a05d9b4 docs(spec): Add Connection Mode dropdown to ServerCard wireframes
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>
2025-12-10 09:23:32 -07:00
olaservo
ecccbb0b7f docs: add per-tool metadata feature to Tools Screen
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>
2025-12-07 21:26:29 -07:00
olaservo
5eaddd1eb6 docs: update Server Card ASCII art with all buttons
- 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>
2025-12-07 21:20:34 -07:00
olaservo
1d8254cb4d docs: add OAuth Debug button to Card Actions list
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-07 21:18:07 -07:00
olaservo
b66b674430 docs: revise v2 specs based on PR feedback
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>
2025-12-07 21:06:20 -07:00
olaservo
79b5e9fdd3 Add full MCP 2025-11-25 protocol coverage to v2_ux.md
- Add server.json import support (Issue #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>
2025-11-30 06:39:24 -07:00
olaservo
8fec93fa5a Add v2_ux.md specification with detailed UX patterns
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>
2025-11-29 21:29:46 -07:00
olaservo
dfb0f1436a Vote for Express and Pino in tech stack decisions
- 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>
2025-11-29 21:18:01 -07:00
Ola Hungerford
59b59286e3
Merge pull request #942 from cliffhall/v2/main
Intialize V2/main
2025-11-28 20:02:51 -07:00
cliffhall
fb88a0c12d Initial contents
* Basic .gitignore
* specification folder with
  * README.md
  * v1_problems.md
  * v2_scope.md
  * v2_tech_stack.md
2025-11-28 17:46:50 -05:00
cliffhall
d5fef7e868 add basic .gitignore 2025-11-28 14:08:28 -05:00
cliffhall
442bb68532 Remove all from v2/main 2025-11-28 13:49:31 -05:00
Ola Hungerford
4e431c9c24
Merge pull request #921 from koic/bump_claude_code_github_action_to_v1 0.17.3 0.17.4
Bump Claude Code GitHub Action to v1
2025-11-20 22:54:41 -07:00
Koichi ITO
b566f0406e Bump Claude Code GitHub Action to v1
Follow-up to https://github.com/modelcontextprotocol/servers/pull/3018.

This PR bumps Claude Code GitHub Action to v1 from beta.
https://github.com/anthropics/claude-code-action/releases/tag/v1
2025-11-19 15:58:30 +09:00
Cliff Hall
dff91a8696
Merge pull request #770 from ln-12/meta_properies_in_tools
Added UI to provide additional _meta values
2025-11-18 14:50:28 -05:00
lorenzo.neumann
c0b3b952f5 Merge branch 'main' of https://github.com/modelcontextprotocol/inspector into meta_properies_in_tools 2025-11-18 15:07:12 +01:00
Cliff Hall
0f67756a7e
Merge pull request #902 from vincent0426/fix/resolve-ref-pre-validation
Fix $ref resolution in request schema properties before validation
2025-11-17 16:46:29 -05:00
Cliff Hall
156e1dcfed
Merge branch 'main' into fix/resolve-ref-pre-validation 2025-11-17 16:38:05 -05:00
Cliff Hall
f93afb062c
Merge pull request #916 from olaservo/fix/typescript-errors
Fix typescript errors and bump version
2025-11-17 16:37:54 -05:00
Konstantin Konstantinov
a5d5593c97
Merge branch 'main' into meta_properies_in_tools 2025-11-15 01:34:22 +02:00
Konstantin Konstantinov
a45247a4f2
add validations against spec, add reserved metadata key validations 2025-11-15 01:26:13 +02:00
olaservo
54a9e7a8b8 Bump version to 0.17.4
Version 0.17.3 had TypeScript build errors that prevented successful builds. This patch release fixes those errors and bumps the version to 0.17.4.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-14 06:38:44 -07:00
olaservo
a33699f8e3 Fix notification parameters in HistoryAndNotifications tests 2025-11-14 05:25:56 -07:00
olaservo
c93c10beca Add typegaurd for blob 2025-11-14 05:25:36 -07:00
Vincent
6106b1b562 fix: Remove incorrect nested test 2025-11-13 14:30:28 -08:00