574a768e09* feat: add script to generate 300x300 grid-cell.png screenshots for examples
- Add generate-grid-screenshots.spec.ts Playwright test to capture screenshots
- Add npm run generate:screenshots command (Docker-based for Santa compatibility)
- Add sharp dependency for image resizing with centered-fill mode
- Generate grid-cell.png for 14 example servers (only React for basic-server-* series)
The screenshots are 300x300 PNG images cropped with centered fill mode,
suitable for use in a grid layout showcasing the examples.
* docs: add example gallery grid to README
Add a 3-column visual grid showcasing 14 example MCP Apps with:
- Thumbnail screenshots (300x300 grid-cell.png)
- Clickable links to example directories
- Hover tooltips with brief descriptions
Organized by visual impact: 3D/WebGL examples first, then
visualizations, charts, monitoring, and starter templates.
* fix: use aspect-fit instead of crop for screenshots
Change from fit: 'cover' (crops) to fit: 'contain' (letterbox)
so the full app content is visible without cropping.
* feat: improve screenshot generation
- Constrain viewport to 500px width for consistent rendering
- Wait 5 seconds for full app load (tiles, animations, data)
- Screenshot just the inner iframe (no extra whitespace)
- Save both screenshot.png (full-size) and grid-cell.png (300x300 thumbnail)
- Use contain mode to preserve aspect ratio
* fix: use cover mode with top alignment for grid thumbnails
No letterboxing - crops to fill 300x300, aligned to top so headers
and important content are always visible.
* feat: improve screenshot gallery
- Remove integration-server from gallery (it's for E2E testing only)
- Add 30s extra wait for Map and Video servers to load fully
- Improve Three.js default scene: isometric rotation + better lighting
- Update README: Starter Templates row with links to all framework variants
(React, Vue, Svelte, Preact, Solid, Vanilla JS)
- Regenerate all screenshots with updated settings
* fix: improve README gallery layout
- Fix uneven column widths by using minimal separator
- Move Starter Templates to separate 2-cell table with description
- Add screenshot.png to top of each example README (13 examples)
- Shorten tooltips for cleaner table
* revert to document.write again; cesiumjs doesn't like srcdoc, period.
* fix: map-server screenshot now renders properly
- Merged ochafik/post-fixes which reverts sandbox from srcdoc to document.write
(CesiumJS doesn't work with srcdoc iframes)
- Fixed map-server name in screenshot test ('Map Server' not 'CesiumJS Map Server')
- Simplified screenshot generation script (removed complex debugging code)
- Increased map-server wait time to 45s for reliable tile loading
- Regenerated all 13 screenshots
* fix: remove redundant screenshots from READMEs
Remove the simple \ line from READMEs that
already had nicer HTML table screenshots. Keep it only for examples
that didn't have existing screenshots.
* docs: move gallery to Examples section
- Move screenshot gallery from top of README to Examples section
- Remove redundant list of basic examples (now shown visually in gallery)
- Clean up duplicate run instructions
* fix: remove empty header row from starter templates table
* fix: remove empty header rows from both tables
* fix: add prettier-ignore to prevent table header expansion
* feat: use custom screenshot for video-resource-server
- Use better screenshot from PR #253 comment showing actual video playback
- Skip video-resource-server in screenshot generation script
- Add SKIP_SERVERS set for manually maintained screenshots
* fix: revert unrelated map-server name change
* fix: use correct server name 'CesiumJS Map Server' in screenshot test
129 lines
4.8 KiB
JSON
129 lines
4.8 KiB
JSON
{
|
|
"name": "@modelcontextprotocol/ext-apps",
|
|
"repository": {
|
|
"type": "git",
|
|
"url": "https://github.com/modelcontextprotocol/ext-apps"
|
|
},
|
|
"homepage": "https://github.com/modelcontextprotocol/ext-apps",
|
|
"version": "0.4.0",
|
|
"license": "MIT",
|
|
"description": "MCP Apps SDK — Enable MCP servers to display interactive user interfaces in conversational clients.",
|
|
"type": "module",
|
|
"main": "./dist/src/app.js",
|
|
"exports": {
|
|
".": {
|
|
"types": "./dist/src/app.d.ts",
|
|
"default": "./dist/src/app.js"
|
|
},
|
|
"./app-with-deps": {
|
|
"types": "./dist/src/app.d.ts",
|
|
"default": "./dist/src/app-with-deps.js"
|
|
},
|
|
"./react": {
|
|
"types": "./dist/src/react/index.d.ts",
|
|
"default": "./dist/src/react/index.js"
|
|
},
|
|
"./react-with-deps": {
|
|
"types": "./dist/src/react/index.d.ts",
|
|
"default": "./dist/src/react/react-with-deps.js"
|
|
},
|
|
"./app-bridge": {
|
|
"types": "./dist/src/app-bridge.d.ts",
|
|
"default": "./dist/src/app-bridge.js"
|
|
},
|
|
"./server": {
|
|
"types": "./dist/src/server/index.d.ts",
|
|
"default": "./dist/src/server/index.js"
|
|
},
|
|
"./schema.json": "./dist/src/generated/schema.json"
|
|
},
|
|
"files": [
|
|
"dist"
|
|
],
|
|
"workspaces": [
|
|
"examples/*"
|
|
],
|
|
"scripts": {
|
|
"postinstall": "node scripts/setup-bun.mjs || echo 'setup-bun.mjs failed or not available'",
|
|
"start": "npm run examples:dev",
|
|
"generate:schemas": "tsx scripts/generate-schemas.ts && prettier --write \"src/generated/**/*\"",
|
|
"build": "npm run generate:schemas && node scripts/run-bun.mjs build.bun.ts",
|
|
"prepack": "npm run build",
|
|
"build:all": "npm run examples:build",
|
|
"test": "bun test src",
|
|
"test:e2e": "playwright test",
|
|
"test:e2e:update": "playwright test --update-snapshots",
|
|
"test:e2e:ui": "playwright test --ui",
|
|
"test:e2e:docker": "docker run --rm -v $(pwd):/work -w /work -it mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'npm i -g bun && npm ci && npx playwright test'",
|
|
"test:e2e:docker:update": "docker run --rm -v $(pwd):/work -w /work -it mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'npm i -g bun && npm ci && npx playwright test --update-snapshots'",
|
|
"preexamples:build": "npm run build",
|
|
"examples:build": "bun examples/run-all.ts build",
|
|
"examples:start": "NODE_ENV=development npm run build && bun examples/run-all.ts start",
|
|
"examples:dev": "NODE_ENV=development bun examples/run-all.ts dev",
|
|
"watch": "nodemon --watch src --ext ts,tsx --exec 'bun build.bun.ts'",
|
|
"prepare": "node scripts/setup-bun.mjs && npm run build && husky",
|
|
"docs": "typedoc",
|
|
"docs:watch": "typedoc --watch",
|
|
"generate:screenshots": "docker run --rm -v $(pwd):/work -w /work mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'npm i -g bun && npm ci && npx playwright test tests/e2e/generate-grid-screenshots.spec.ts'",
|
|
"prettier": "prettier -u \"**/*.{js,jsx,ts,tsx,mjs,json,md,yml,yaml}\" --check",
|
|
"prettier:fix": "prettier -u \"**/*.{js,jsx,ts,tsx,mjs,json,md,yml,yaml}\" --write",
|
|
"check:versions": "node scripts/check-versions.mjs"
|
|
},
|
|
"author": "Olivier Chafik",
|
|
"devDependencies": {
|
|
"@modelcontextprotocol/sdk": "^1.24.0",
|
|
"@playwright/test": "^1.52.0",
|
|
"@types/bun": "^1.3.2",
|
|
"@types/react": "^19.2.2",
|
|
"@types/react-dom": "^19.2.2",
|
|
"concurrently": "^9.2.1",
|
|
"cors": "^2.8.5",
|
|
"cross-env": "^10.1.0",
|
|
"esbuild": "^0.25.12",
|
|
"express": "^5.1.0",
|
|
"husky": "^9.1.7",
|
|
"nodemon": "^3.1.0",
|
|
"prettier": "^3.6.2",
|
|
"react": "^19.2.0",
|
|
"react-dom": "^19.2.0",
|
|
"sharp": "^0.34.5",
|
|
"ts-to-zod": "^5.1.0",
|
|
"tsx": "^4.21.0",
|
|
"typedoc": "^0.28.14",
|
|
"typescript": "^5.9.3",
|
|
"zod": "^4.1.13"
|
|
},
|
|
"peerDependencies": {
|
|
"@modelcontextprotocol/sdk": "^1.24.0",
|
|
"react": "^17.0.0 || ^18.0.0 || ^19.0.0",
|
|
"react-dom": "^17.0.0 || ^18.0.0 || ^19.0.0",
|
|
"zod": "^3.25.0 || ^4.0.0"
|
|
},
|
|
"peerDependenciesMeta": {
|
|
"react": {
|
|
"optional": true
|
|
},
|
|
"react-dom": {
|
|
"optional": true
|
|
}
|
|
},
|
|
"optionalDependencies": {
|
|
"@oven/bun-darwin-aarch64": "^1.2.21",
|
|
"@oven/bun-darwin-x64": "^1.2.21",
|
|
"@oven/bun-darwin-x64-baseline": "^1.2.21",
|
|
"@oven/bun-linux-aarch64": "^1.2.21",
|
|
"@oven/bun-linux-aarch64-musl": "^1.2.21",
|
|
"@oven/bun-linux-x64": "^1.2.21",
|
|
"@oven/bun-linux-x64-baseline": "^1.2.21",
|
|
"@oven/bun-linux-x64-musl": "^1.2.21",
|
|
"@oven/bun-linux-x64-musl-baseline": "^1.2.21",
|
|
"@oven/bun-windows-x64": "^1.2.21",
|
|
"@oven/bun-windows-x64-baseline": "^1.2.21",
|
|
"@rollup/rollup-darwin-arm64": "^4.53.3",
|
|
"@rollup/rollup-darwin-x64": "^4.53.3",
|
|
"@rollup/rollup-linux-arm64-gnu": "^4.53.3",
|
|
"@rollup/rollup-linux-x64-gnu": "^4.53.3",
|
|
"@rollup/rollup-win32-arm64-msvc": "^4.53.3",
|
|
"@rollup/rollup-win32-x64-msvc": "^4.53.3"
|
|
}
|
|
}
|