{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_a2gszxsftfv3","handle":"mcp-ffmpeg-2","url":"https://wellknown.network/agents/mcp-ffmpeg-2","links":{"self":"https://wellknown.network/agents/mcp-ffmpeg-2/record.json","html":"https://wellknown.network/agents/mcp-ffmpeg-2","markdown":"https://wellknown.network/agents/mcp-ffmpeg-2/record.md","api":"https://wellknown.network/api/v1/agents/mcp-ffmpeg-2","status":"https://wellknown.network/api/v1/agents/mcp-ffmpeg-2/status","claim":"https://wellknown.network/agents/mcp-ffmpeg-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-ffmpeg-2/claim.json","badge":"https://wellknown.network/agents/mcp-ffmpeg-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-ffmpeg-2/history","tools":"https://wellknown.network/api/v1/agents/mcp-ffmpeg-2/tools"},"ard":{"identifier":"urn:air::server:mcp-ffmpeg-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-ffmpeg","summary":"A Model Context Protocol server for FFmpeg media processing","description":"# MCP-FFMPEG\n\nAn MCP (Model Context Protocol) server and CLI for running FFmpeg jobs via a job queue with configurable parallel workers.\n\n## Features\n\n- **Job queue** — Enqueue video jobs; workers process them in the background.\n- **Parallel workers** — Run multiple jobs at once (number set in config).\n- **Two interfaces**\n  - **CLI** — Interactive menu to pick an action and enter parameters.\n  - **MCP server** — Tools for AI assistants (e.g. Claude Desktop) to enqueue and check jobs.\n- **Actions**\n  - **Trim** — Cut a segment from a video (start time + duration).\n  - **Change video format** — Convert to another container (e.g. mp4 → mkv) without re-encoding.\n  - **Change resolution** — Convert to another resolution, height and width provided by user.\n  - **Change Subtitle format** — Convert to another subtitle format (e.g. srt -> vtt).\n  - **Extract Audio** - Extract audio from an input video file\n- **Caching** — Same inputs produce the same job ID; completed jobs are reused unless `force_run` is used.\n\n## Requirements\n\n- **Python** 3.13+\n- **FFmpeg** — Must be on your system PATH or set via `FFMPEG_PATH` (see [Configuration](#configuration)).\n\n## Installation\n\nChoose one of the following:\n\n### Option 1: Install from PyPI\n\n```bash\npip install mcp-ffmpeg\n```\n\nOr with [uv](https://docs.astral.sh/uv/):\n\n```bash\nuv add mcp-ffmpeg\n```\n\n### Option 2: Clone the repository\n\n```bash\ngit clone https://github.com/priyanshum143/MCP-FFMPEG.git\ncd MCP-FFMPEG\n```\n\nThen install from the project root:\n\n```bash\n# With uv\nuv sync\n\n# Or with pip (editable install)\npip install -e .\n```\n\n## Configuration\n\n- **FFmpeg path**  \n  - Default: use `ffmpeg` from system PATH.  \n  - Optional: set env var `FFMPEG_PATH` to the full path of the FFmpeg executable (e.g. for Claude Desktop).\n\n- **Worker and paths**  \n  Edit `src/MCP_ffmpeg/utils/variables.py` (class `CommonVariables`):\n  - `PARALLEL_EXECUTIONS_ALLOWED` — Number of jobs that can run at once (default: 3).\n  - `WORKER_RE_RUN_TIME` — Sec…","publisher":null,"homepage":"https://github.com/priyanshum143/MCP-FFMPEG","repository":"https://github.com/priyanshum143/MCP-FFMPEG","version":"0.1.6","license":"MIT","protocols":["mcp"],"tags":["audio","ffmpeg","mcp","processing","video"],"pricing":null,"endpoints":[{"url":"pypi:mcp-ffmpeg","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.video-editing","name":"Video Editing","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"}],"categories":["dev","media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-ffmpeg","registry":"pypi","observedAt":"2026-11-03T13:26:39.182Z","publishedAt":"2026-04-13T04:32:15.303689Z","latestVersion":"0.1.6"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-ffmpeg","url":"https://pypi.org/project/mcp-ffmpeg/","firstSeenAt":"2026-09-10T01:20:45.855Z","fetchedAt":"2026-11-03T13:25:16.010Z","normalizedAt":"2026-11-03T13:25:16.010Z"}]},"firstSeenAt":"2026-09-10T01:20:45.855Z","updatedAt":"2026-11-03T13:26:39.182Z"}