ext-apps/examples/video-resource-server
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Olivier Chafik 6b12fff1d0
chore: bump ext-apps to 1.2.0 (#527)
* chore: bump ext-apps to 1.1.3

Changes since 1.1.2:
- fix: autoResize reporting viewport height when content is taller (#525)
- fix: remove duplicate --color-text-ghost from McpUiStyleVariableKey (#523)
- fix: examples servers' npm run start:stdio (#507)
- pdf-server: ignore client roots by default (#510)
- docs: add Security documentation section and SEO improvements (#524)
- docs: add MCP client configuration examples to CONTRIBUTING.md (#508, #526)
- docs: use apps.extensions.modelcontextprotocol.io domain for docs URLs (#499)
- docs: add SECURITY.md with GitHub Security Advisories guidance (#472)

* chore: switch to minor bump 1.2.0 (new APIs in #470)
2026-03-06 15:43:55 +00:00
..
src fix: make listServerResources() params optional (#528) 2026-03-06 14:30:36 +00:00
.gitignore Improve consistency and organization of examples for AI learning 2026-01-13 20:48:02 -06:00
grid-cell.png feat: add example gallery with auto-generated screenshots (#253) 2026-01-13 15:12:18 +00:00
main.ts Refactor server startup functions 2026-01-24 09:27:54 -06:00
mcp-app.html feat: add readServerResource() and listServerResources() api to App (#470) 2026-03-06 14:20:45 +00:00
package.json chore: bump ext-apps to 1.2.0 (#527) 2026-03-06 15:43:55 +00:00
README.md chore: stable spec release 2026-01-26 and SDK v1.0.0 (#362) 2026-01-26 17:31:33 +00:00
screenshot.png feat: add example gallery with auto-generated screenshots (#253) 2026-01-13 15:12:18 +00:00
server.ts feat: add readServerResource() and listServerResources() api to App (#470) 2026-03-06 14:20:45 +00:00
tsconfig.json Support safeAreaInsets + type-checking in video-resource-server 2026-01-07 17:14:20 -06:00
tsconfig.server.json feat: compile example servers to JavaScript for npm consumption (#259) 2026-01-14 23:46:17 +00:00
vite.config.ts feat(examples): Add video-resource-server example 2026-01-06 16:43:46 +00:00

Video Resource Server

Screenshot

Demonstrates serving binary content (video) via MCP resources using the base64 blob pattern.

MCP Client Configuration

Add to your MCP client configuration (stdio transport):

{
  "mcpServers": {
    "video-resource": {
      "command": "npx",
      "args": [
        "-y",
        "--silent",
        "--registry=https://registry.npmjs.org/",
        "@modelcontextprotocol/server-video-resource",
        "--stdio"
      ]
    }
  }
}

Local Development

To test local modifications, use this configuration (replace ~/code/ext-apps with your clone path):

{
  "mcpServers": {
    "video-resource": {
      "command": "bash",
      "args": [
        "-c",
        "cd ~/code/ext-apps/examples/video-resource-server && npm run build >&2 && node dist/index.js --stdio"
      ]
    }
  }
}

Quick Start

npm install
npm run dev

Tools

  • play_video - Plays a video loaded via MCP resource
    • videoId: Choose from various sizes (bunny-1mb, bunny-5mb, bunny-10mb, etc.)

How It Works

  1. The play_video tool returns a videoUri pointing to an MCP resource
  2. The view fetches the resource via resources/read
  3. The server fetches the video from CDN and returns it as a base64 blob
  4. The view decodes the blob and plays it in a <video> element