encoding-devops
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@encoding-devops What's wrong with job XYZ-123?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🎬 Encoding DevOps MCP Server: AI-Powered Video Encoding Assistant
Ever been woken up at 3 AM by a failed encoding job? Say goodbye to those late-night troubleshooting sessions! This Model Context Protocol (MCP) server connects Anthropic's Claude directly to your encoding workflow, making video encoding issues a breeze to handle.
✨ What's Cool About This?
Smart Error Translation: Turns cryptic "moov atom not found" messages into plain English
Real-time Analysis: Connects directly to your encoding workflow and database
Human-Friendly Responses: Generates clear, actionable solutions for your team
Auto-Email Draft: Creates professional client communications with context
Always On Guard: Monitors your encoding jobs 24/7
Keeps You in Control: Suggests actions but lets you make the final call
Related MCP server: envious-canvas
🚀 Getting Started
You'll Need
Python 3.11 or higher
Claude Desktop
Your encoding workflow API credentials
OMDB API key (optional, for movie metadata)
Quick Setup
Install the package using UV:
curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install encoding-devopsSet up your environment:
# Copy the example config
cp .env.example .env
# Add your API keys
nano .envRegister with Claude Desktop:
uv run mcp install ./src/encoding_devops/main.py💡 How to Use It
# Start the MCP server
uv run mcp dev ./src/encoding_devops/main.py
# In Claude Desktop, you can now ask things like:
"What's wrong with job XYZ-123?"
"Draft an email about the failed encoding job"
"Check the encoding cluster status"🔧 Under the Hood
The MCP server uses three main components to help you:
Resources: Email templates, error guides, and documentation
Tools: Job status checks, log analysis, and email drafting
Prompts: Instructions that help Claude understand encoding issues
🤝 Want to Help?
We'd love your input! Here's how you can contribute:
Fork it
Create your feature branch (
git checkout -b feature/awesome-feature)Commit your changes (
git commit -m 'Add awesome feature')Push to the branch (
git push origin feature/awesome-feature)Open a Pull Request
📋 Coming Soon
Integration with more encoding workflow systems
Advanced log analysis patterns
Automated health checks
Slack notifications
Custom email templates
📝 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙌 Thanks To
Anthropic team for the MCP framework
All our contributors
The DevOps community for feedback and suggestions
💤 Built by a developer who wanted to sleep through the night. If this helps you too, give us a star!
Read the full story behind this project in my Medium article about using MCP to handle encoding fires.
Available Tools
8 toolsget_clientsB
Get list of all clients
Inputs: no named parameters.
get_job_by_nameC
Get details of an encoding job by its name
Inputs: name (required).
get_job_tasks_by_idC
Get tasks for a specific job by its ID
Inputs: job_id (required).
get_latest_jobsB
Get the most recent encoding jobs
Args:
limit: Number of jobs to return (default: 3, max: 10)
Returns:
String representation of the latest jobs
Inputs: limit (required).
get_movie_detailsB
Get detailed information about a movie by its IMDB ID
Args:
imdb_id: IMDB ID of the movie (e.g., 'tt0111161')
Returns:
String representation of the movie details
Inputs: imdb_id (required).
is_cluster_busyB
Check if the encoding cluster is busy (has jobs in progress)
Inputs: no named parameters.
open_emailA
Opens the default email client with your message ready to go
Args:
body: What you want to say in the email
to: Who to send it to (optional)
subject: Email subject line (optional)
cc: CC recipients (optional)
bcc: BCC recipients (optional)
ctx: MCP context
Returns:
str: Quick status message so you know it worked
Inputs: body (required), cc, to, bcc, +1 more.
search_movieC
Search for a movie by title
Args:
title: Movie title to search for
Returns:
String representation of the search results
Inputs: title (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools target clear, distinct resources (clients, cluster status, movie search, email). The three job-related tools (get_job_by_name, get_job_tasks_by_id, get_latest_jobs) share a resource but differ in intent, so only minor confusion is possible.
Names follow a consistent snake_case verb_noun pattern (get_job_by_name, get_movie_details, search_movie). The is_cluster_busy predicate is a reasonable deviation for a boolean check rather than a true inconsistency.
Eight tools is well-scoped for this domain, with each covering a distinct query. No redundant or filler tools pad the surface.
The surface is read-only: it exposes job lookups, cluster status, and movie info but no submit/create/cancel/retry job operations, which are core to an encoding-ops workflow. Client and email handling are present but job lifecycle coverage is one-sided.
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
MCP server for Wan AI video generation
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence
Related MCP Servers
- AlicenseBqualityCmaintenanceAn MCP server that integrates Shaka Packager with Claude AI applications, enabling Claude to analyze, transcode, and package video files for streaming in formats like HLS and DASH.44MIT
- AlicenseAqualityDmaintenanceAn MCP server that turns Claude into a full image production studio, enabling creation, editing, resizing, and brand-consistent asset generation across multiple platforms.6MIT
- FlicenseBqualityDmaintenanceMCP server that enables video analysis capabilities to Claude, including frame extraction, scene detection, and video metadata retrieval.8-
- FlicenseNot gradedqualityBmaintenanceMCP server for managing video pipelines, integrating media processing (TTS, STT, image generation) and video editing, with a structured plugin system and tunnel to Claude AI Web.-