96daa46a1d* feat(pdf-server): Interactive PDF viewer example
PDF viewer with PDF.js featuring:
- Chunked binary loading with progress bar
- Text extraction for AI context
- arXiv paper support (fetch by ID)
- Page navigation with keyboard shortcuts
- Zoom controls (including Ctrl+0 reset)
- Fullscreen mode support
- Horizontal swipe for page changes (disabled when zoomed)
- Page persistence in localStorage
- Text selection via PDF.js TextLayer
- Clickable title link to source URL
- Rounded corners and subtle border styling
* chore: Add pdf-server to screenshot generation list
* refactor(pdf-server): Simplify and generalize PDF loading
- Accept any HTTP(s) URLs instead of ArXiv-only
- Use HTTP Range requests for chunked binary loading
- Remove ArXiv-specific code (arxiv.ts, metadata fetching)
- Remove CLAUDE.md index generation
- Flatten hierarchical folder structure to simple entries list
- Remove dead code: getPdfSummary, httpFileSizes
- Simplify base64 encoding using Buffer
- Simplify chunk extraction using slice()
- Consolidate DEFAULT_PDF_URL constant
The server now works with any PDF URL, not just arXiv papers.
HTTP Range requests stream chunks on-demand when supported.
* feat(pdf-server): Include title and selection in model context
- Add pdfTitle to updateModelContext structuredContent
- Include selection position (text, start, end) when text is selected
- Add debounced selectionchange listener to update context on selection
* fix(pdf-server): Restore default URL in view_pdf schema
The UI needs the default value in the schema to show it properly.
* refactor(pdf-server): Further simplifications
- Remove hard-coded test paths from main()
- Remove unused resources: pdfs://metadata/{pdfId}, pdfs://content/{pdfId}
- Remove unused metadata fields: subject, creator, producer, creationDate, modDate
- Remove unused entry fields: relativePath, estimatedTextSize
- Remove filterEntriesByFolder and folder filter from list_pdfs
- Remove redundant output schema validation (trust typed returns)
- Simplify scanDirectory and createLocalEntry signatures
Total: 1836 → 1666 lines (-170 lines, -9%)
* refactor(pdf-server): Major simplification for didactic focus
Simplified the example to focus on key MCP Apps SDK patterns:
- Chunked data through size-limited tool calls
- Model context updates (page text + selection)
- Display modes (fullscreen vs inline)
- External links (openLink)
Changes:
- Remove local file support (HTTP URLs only)
- Restrict dynamic URLs to arxiv.org for security
- Simplify types: url instead of sourcePath/sourceType
- Simplify indexer: 168 → 44 lines
- Simplify loader: 318 → 171 lines
- Simplify server: 337 → 233 lines
- Fix selection text normalization
- Rewrite README with didactic focus
Total: 1836 → 1236 lines (-33%)
* feat(pdf-server): Add file:// URL support for local files
- Local paths are converted to file:// URLs on startup
- file:// URLs must be in the initial list (strict validation)
- Dynamic URLs still restricted to arxiv.org only
- Updated README with local file examples
* fix(pdf-server): Improve selection detection with logging
- Add logging to selectionchange handler to verify it fires
- Add fallback matching without spaces (TextLayer spans may lack spaces)
- Log selection detection success/failure for debugging
The issue: PDF.js TextLayer renders text as positioned spans without
space characters between them. When selecting across spans:
- pageText has spaces (items joined with ' ')
- sel.toString() may not have spaces
- indexOf fails to match
The fix tries exact match first, then falls back to spaceless matching.
* feat(pdf-server): Format model context as markdown with front matter
Model context now looks like:
```markdown
---
url: https://arxiv.org/pdf/...
page: 5/144
---
Page text with <pdf-selection>selected text</pdf-selection> inline.
```
This is cleaner for the model to parse and includes the source URL.
* refactor(pdf-server): Extract smart truncation helpers
Added two well-designed helpers:
formatPageContent(text, maxLength, selection?)
- Centers truncation window around selection if present
- Adds <truncated-content/> markers at elision points
- Wraps selection in <pdf-selection> tags
- Allocates 60% context before, 40% after for readability
findSelectionInText(pageText, selectedText)
- Tries exact match first
- Falls back to spaceless match for TextLayer quirks
- Returns { start, end } or undefined
Example output with selection:
```
<truncated-content/>
...context before... <pdf-selection>selected text</pdf-selection> ...context after...
<truncated-content/>
```
* fix(pdf-server): Truncate inside selection tags when selection too long
When selection is too large for the budget:
<truncated-content/><pdf-selection><truncated-content/>start...end<truncated-content/></pdf-selection><truncated-content/>
This keeps the selection structure intact while showing beginning and end.
* refactor(pdf-server): Remove unused read_pdf_text, use Attention paper as default
- Remove read_pdf_text tool (viewer extracts text client-side with pdfjs)
- Remove PdfTextChunk and ReadPdfTextInput types
- Remove loadPdfTextChunk from pdf-loader
- Change default PDF to 'Attention Is All You Need' (1706.03762)
- Update README with modest language
* refactor(pdf-server): Simplify to use URL as ID, rename view_pdf to display_pdf
Major simplifications:
- Use URL directly as identifier (no hashing)
- Remove displayName - show elided URL with full URL as tooltip
- Rename view_pdf to display_pdf with better description
- Update all references from pdfId to url
- Simplify storage key and model context
The tool description now explains it displays an interactive viewer in the chat.
* feat(pdf-server): Normalize arxiv URLs to PDF format
arxiv.org/abs/... -> arxiv.org/pdf/...
Applied both at startup and when loading dynamic URLs.
* docs(pdf-server): Add prompt engineering to display_pdf description
* fix(pdf-server): Sharp rendering on retina displays
Account for devicePixelRatio when rendering canvas:
- Scale canvas dimensions by dpr
- Scale context by dpr
- Keep CSS size at logical pixels
* fix(pdf-server): Normalize arxiv URLs in read_pdf_bytes too
* add to e2e spec
* add to e2e spec
* add to e2e spec
* add to e2e spec
* regen
* chore: regenerate package-lock.json and fix hono vulnerability
* docs: add pdf-server screenshot to READMEs
* regen
* ci: add missing examples to pkg-pr-new publish
* ci: add pdf-server to npm publish examples
* Update README.md
* pdf-server: improve tool response text for better model context
* revert unrelated screenshot changes
* pdf-server: dynamically add arxiv URLs in read_pdf_bytes
Fixes 'PDF not found' error when server restarts between display_pdf
(which adds the entry) and read_pdf_bytes (which previously only looked
up existing entries). Now read_pdf_bytes mirrors display_pdf's logic
and dynamically adds arxiv URLs to the index.
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": "npm run build:all && 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": "npm run build:all && 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"
|
|
}
|
|
}
|