open-video-upload-helper
v1.2.0
Published
Local upload companion for the open.video MCP server — enables AI agents to upload videos and images from your device
Downloads
138
Readme
open-video-upload-helper
Local upload companion for the open.video MCP server. Enables AI agents (Cursor, Windsurf, Claude Code) to upload videos and images directly from your device.
Why is this needed?
The open.video MCP server runs remotely at https://mcp.open.video/mcp and can't access files on your machine. This lightweight local companion bridges the gap — when the remote server detects a local file path, it hands off to this helper to read and upload the file.
Setup
Add both servers to your MCP config:
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"open-video": {
"url": "https://mcp.open.video/mcp"
},
"open-video-upload": {
"command": "npx",
"args": ["-y", "open-video-upload-helper"]
}
}
}Claude Code:
claude mcp add open-video -- https://mcp.open.video/mcp
claude mcp add open-video-upload -- npx -y open-video-upload-helperWindsurf (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"open-video": {
"url": "https://mcp.open.video/mcp"
},
"open-video-upload": {
"command": "npx",
"args": ["-y", "open-video-upload-helper"]
}
}
}No npm install needed — npx -y auto-downloads and caches the package.
What it provides
Three local upload tools:
| Tool | Description |
|------|-------------|
| openvideo_upload_local_video | Upload a video file (MP4, MKV, MOV, WebM) |
| openvideo_continue_upload | Resume an interrupted video upload |
| openvideo_upload_local_image | Upload an image (PNG, JPG, GIF, WebP) for thumbnails or channel branding |
How it works
- You ask the AI agent to upload a local file
- The remote MCP server generates a scoped upload token and tells the agent to use the local helper
- The local helper reads the file from disk and uploads it directly to open.video
- No credentials are stored locally — each upload uses a one-time token
Supported formats
- Video:
.mp4,.mkv,.mov,.webm - Images:
.png,.jpg,.jpeg,.gif,.webp
Claude Desktop users
Claude Desktop users should install the Upload Helper extension instead — it provides the same functionality as a native desktop extension (no npx needed).
Links
- open.video — video publishing platform
- MCP server — remote MCP endpoint
- GitHub — source code
License
Copyright © Ezoic Inc. All rights reserved.
