| Filename | Latest commit message | Latest commit date |
|---|---|---|
50eb30ec8d
The client, core and server packages become ^2.0.0 peers and client is now a required peer (App and AppBridge extend its Protocol class); server stays optional for View-only consumers. Examples move to zod ^4.2.0 to match the library peer range. The root package is not yet published at 2.0.0, so the lockfile now links the examples' @modelcontextprotocol/ext-apps dependency to the repository root instead of a registry copy. This drops the stale 1.x tarball (and its sdk 1.x peer) from the lockfile and makes scripts/link-self.mjs a no-op. |
||
| .. | ||
| src | ||
| .gitignore | ||
| grid-cell.png | ||
| main.ts | ||
| mcp-app.html | ||
| package.json | ||
| README.md | ||
| screenshot.png | ||
| server.ts | ||
| tsconfig.json | ||
| tsconfig.server.json | ||
| vite.config.ts | ||
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.