ext-apps/examples/video-resource-server at main · modelcontextprotocol/ext-apps · GitHub
Skip to content

Latest commit

 

History

History

video-resource-server

README.md

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