AzadKurt/videoworker-mcp

Give your AI agent FFmpeg: upload local media, run a remote job, and save the result.
An MIT-licensed, local stdio MCP connector for the videoworker
video, audio and image processing API. Bring standard FFmpeg arguments; our workers
run them. No local FFmpeg installation required.
Get started free ·
Hosted MCP ·
REST API ·
Releases ·
Listed on Glama
## Choose your connection
| | Local connector — this repo | Hosted MCP |
| Best for | Local file uploads and downloads | Connecting without installing Python |
| Transport | stdio | Streamable HTTP |
| Sign in | Scoped API key in a private file | Browser login and OAuth consent |
| Local file access | Named media in your selected folders | None; upload via web or REST first |
| Setup | Quick start below | Hosted setup guide |
Both use the same account and allowance. The connector is free software; hosted
processing follows the current plans and limits.
Free accounts receive a small monthly allowance. Check pricing for the Starter
launch offer and its availability; a trial is not required to use Free.
## Quick start
### 1. Install — no checkout or Git needed
Requires Python 3.12 or newer. Install the versioned release wheel:
sh
python -m pip install "https://github.com/AzadKurt/videoworker-mcp/releases/download/v0.2.0/videoworkermcp-0.2.0-py3-none-any.whl"
python -m videoworkermcp --version
On Windows, use py -3.12 instead of python if needed. On macOS/Linux, your
command may be python3. Use that same Python installation in your MCP config.
Print its full path with:
sh
python -c "import sys; print(sys.executable)"
Alternative with Git installed:
sh
python -m pip install "git+https://github.com/AzadKurt/videoworker-mcp.git@v0.2.0"
This package is not on PyPI yet. pip install videoworker-mcp is not the command
for this release.
### 2. Create your workspace and private key file
Sign in to your workspace. Under API keys,
create a key with usage:read, files:write, jobs:read, jobs:write and
outputs:read for all ten tools. Save it as plain text in a file accessible
only to your user. On macOS/Linux: chmod 600 /absolute/path/to/key. On Windows,
keep it in your user profile and restrict its file permissions to you.
Create uploads and downloads folders. Both must exist and use absolute
paths. Keep only authorized media in uploads; keep the key file elsewhere.
Never paste the key into a chat or a shared client config.
### 3. Add your client config
Replace the Python and file/folder paths with your own. Merge the entry into an
existing config, preserving other servers. The values are paths, not secrets.
Restart or reload your client after saving.
#### Codex
Add to ~/.codex/config.toml:
toml
[mcpservers.videoworker]
command = "/absolute/path/to/python"
args = ["-m", "videoworkermcp"]
startuptimeoutsec = 30
tooltimeoutsec = 960
[mcpservers.videoworker.env]
VIDEOWORKERAPIKEYFILE = "/absolute/path/to/videoworker.key"
VIDEOWORKERUPLOADROOT = "/absolute/path/to/uploads"
VIDEOWORKERDOWNLOADROOT = "/absolute/path/to/downloads"
Windows forward-slash paths work, e.g. C:/Users/YOU/media/uploads. Ready-to-edit:
Windows / macOS and Linux.
Keep the hosted connection named videoworkerremote if you also use it.