Skip to content

Latest commit

 

History

History

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