mp-mcp
Receives incoming photos, documents, and videos via Telegram (through prime-tg) into the media pipeline's inbox, where they are automatically picked up and processed by the local inbox watch.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
media-pipeline
Local CPU-only processing for video, audio, and images. FFmpeg reads containers and writes video and audio. faster-whisper transcribes speech on CPU with int8 weights. RapidOCR reads printed text in images through ONNX Runtime. Translation of the extracted text is optional.
Whisper defaults are model tiny and compute type int8 (MP_WHISPER_MODEL, MP_WHISPER_COMPUTE). The default input limit is 512 MB (MP_MAX_INPUT_BYTES).
What a job writes
Input | Engine | Files |
video: | FFmpeg ( |
|
video, or audio: | FFmpeg, then faster-whisper | 16 kHz mono PCM under |
image: | RapidOCR (PP-OCRv4) |
|
extracted text, when translation is requested | Pollinations, then Gemini, then a LiteLLM proxy |
|
Each job is a directory outbox/<epoch>_<stem>/ and includes manifest.json. The 16 kHz wav stays in work/.
mp process transcribes speech and runs OCR. It translates only with --translate. mp translate always translates. The default target language is tr (MP_TRANSLATE_TARGET).
MP_LLM_PROVIDER defaults to auto: Pollinations with no key (MP_POLLINATIONS_MODEL, default openai), then Gemini when MP_GEMINI_KEY is set (MP_GEMINI_MODEL, default gemini-2.0-flash), then LiteLLM when MP_LITELLM_KEY and MP_LITELLM_MODEL are set (MP_LITELLM_BASE, default http://127.0.0.1:4000/v1). MP_LLM_PROVIDER=none leaves translation unconfigured.
requirements.txt lists faster-whisper, pillow, onnxruntime, and rapidocr-onnxruntime. mp selftest imports Pillow. Image jobs write OCR text. FFmpeg and ffprobe have to be on PATH. bin/mp runs .venv/bin/python when it exists, then python3.11, then python3.
Related MCP server: mcp-ffmpeg
CLI
bin/mp probe FILE
bin/mp process FILE [--no-stt] [--no-ocr] [--translate] [--target LANG]
bin/mp translate FILE [--target LANG]
bin/mp list
bin/mp watch
bin/mp selftest
bin/mp doctorprobe prints ffprobe metadata. process handles one file and leaves it in place. list prints names in inbox/, outbox/, and failures/. watch handles each non-hidden file in inbox/ in filename order, then moves it to outbox/ or, on error, to failures/. A sha256 already stored in work/processed.json stays in inbox/. selftest prints whether ffmpeg, ffprobe, faster-whisper, RapidOCR, and Pillow are usable, and exits 0. doctor adds the skill files, an MCP handshake, the user systemd units, ~/.prime/agent/settings.json, and $HOME/bin/prime-tg. A failed critical check exits 1. prime-tg is not in this repository; a missing binary fails doctor.
MCP server
bin/mp-mcp is a stdio JSON-RPC MCP server. Tools:
media_enginesmedia_probe(path)media_process(path,transcribe,ocr,translate,target_language)media_translate(path,target_language)media_batch(everything ininbox/, transcription and OCR on, translation off)
mcp-server.json in the repo points at /home/opc/work/prime/media-pipeline. install.sh rewrites command and cwd to this checkout.
Skill
skills/media-pipeline/SKILL.md and the notes in skills/media-pipeline/references/ describe the same commands.
Install
./install.sh:
creates
inbox/,work/,outbox/,failures/, andlogs/copies the skill into
$MP_SKILLS_DIR/media-pipelinewhen that directory already exists (default$HOME/.local/share/prime-agent/0.9.6/skills)rewrites
mcp-server.jsonwhen a
prime-agentbinary is onPATHor at$HOME/.local/share/prime-agent/*/prime-agent, runsprime-agent mcp add media-pipeline --force --cwd <repo> -- <repo>/bin/mp-mcpwrites
$HOME/.config/systemd/user/mp-inbox.pathandmp-inbox.service, then enables the path unit ifsystemctlis availablechecks the MCP handshake and runs
bin/mp selftest
The script overwrites the manifest, the copied skill files, and the user units. It can be run again.
Inbox watch
The user path unit watches inbox/ (PathChanged) and starts a oneshot service that runs bin/mp watch with a 1800s start timeout. systemd/mp-inbox.path and systemd/mp-inbox.service are the same units with /home/opc/work/prime/media-pipeline baked in. The service file written by install.sh also sets After=default.target.
work/, outbox/, failures/, logs/, and inbox contents other than .gitkeep are gitignored.
License
MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Transform video, audio and images, and generate media from prompts. FFmpeg, captions, models.
FFmpeg processing for video, audio and images via MCP with OAuth and shared account allowance.
Hosted MCP tools for FFmpeg-style video and audio processing through FFMPEG API.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables high-quality transcription and subtitle generation from local media files or URLs using Faster Whisper on local hardware. It supports automatic language detection and integration with MCP clients for seamless speech-to-text workflows.31-
- AlicenseAqualityDmaintenanceEnables local media processing (video/audio) using FFmpeg and FFprobe, allowing frame extraction, audio conversion, and metadata retrieval through natural language.5MIT
- AlicenseAqualityDmaintenanceEnables MCP clients to transcribe audio/video files locally, generate SRT subtitles, and burn captions into videos via tool calls, without a cloud API.3MIT
- AlicenseAqualityBmaintenanceEnables local, CPU-only image and video manipulation—such as background removal, resizing, format conversion, thumbnails, GIF creation, and trimming—through an MCP server without API keys, GPU, or paid dependencies.8MIT