Watch

History

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Olivier Chafik 8e7206cb15 chore(deps): npm audit fix — sdk 1.29.0, systeminformation 5.31.5, +13 transitives (#585 ) Clears all 15 npm audit findings (8 high / 6 moderate / 1 low): - @modelcontextprotocol/sdk 1.25.2 → 1.29.0 (GHSA-345p-7cg4-v4c7 cross-client data leak via shared transport reuse). Root had it pinned exact in devDependencies which blocked audit fix. - systeminformation 5.30.6 → 5.31.5 (GHSA-5vv4-hvf7-2h46, GHSA-9c88-49p5-5ggf command injection) - hono, undici, rollup, picomatch, minimatch, lodash-es, svelte, devalue, ajv, brace-expansion, markdown-it, yaml, qs — lockfile bumps via npm audit fix		2026-04-02 04:25:00 +01:00
..
src	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
.gitignore	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
grid-cell.png	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
main.ts	Refactor server startup functions	2026-01-24 09:27:54 -06:00
mcp-app.html	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
package.json	chore(deps): npm audit fix — sdk 1.29.0, systeminformation 5.31.5, +13 transitives (#585 )	2026-04-02 04:25:00 +01:00
README.md	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
screenshot.png	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
server.ts	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
tsconfig.json	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
tsconfig.server.json	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00
vite.config.ts	feat(debug-server): add interactive debug server example (#321 )	2026-01-23 12:39:40 +00:00

README.md

Debug Server

A comprehensive testing/debugging tool for the MCP Apps SDK that exercises every capability, callback, and result format combination.

Tools

debug-tool

Configurable tool for testing all result variations:

Parameter	Type	Default	Description
`contentType`	`"text"` \| `"image"` \| `"audio"` \| `"resource"` \| `"resourceLink"` \| `"mixed"`	`"text"`	Content block type to return
`multipleBlocks`	boolean	`false`	Return 3 content blocks
`includeStructuredContent`	boolean	`true`	Include structuredContent in result
`includeMeta`	boolean	`false`	Include _meta in result
`largeInput`	string	-	Large text input (tests tool-input-partial)
`simulateError`	boolean	`false`	Return isError: true
`delayMs`	number	-	Delay before response (ms)

debug-refresh

App-only tool (hidden from model) for polling server state. Returns current timestamp and call counter.

App UI

The debug app provides a dashboard with:

Event Log: Real-time log of all SDK events with filtering
Host Info: Context, capabilities, container dimensions, styles
Callback Status: Table of all callbacks with call counts
Actions: Buttons to test every SDK method:
- Send messages (text/image)
- Logging (debug/info/warning/error)
- Model context updates
- Display mode requests
- Link opening
- Resize controls
- Server tool calls
- File operations

Usage

# Build
npm run --workspace examples/debug-server build

# Run standalone
npm run --workspace examples/debug-server serve

# Run with all examples
npm start

Then open http://localhost:8080/basic-host/ and select "Debug MCP App Server" from the dropdown.