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.
- 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
- Python 3.11 or higher
- Claude Desktop
- Your encoding workflow API credentials
- OMDB API key (optional, for movie metadata)
- Install the package using UV:
curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install encoding-devops
- Set up your environment:
# Copy the example config
cp .env.example .env
# Add your API keys
nano .env
- Register with Claude Desktop:
uv run mcp install ./src/encoding_devops/main.py
# 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"
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
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
- Integration with more encoding workflow systems
- Advanced log analysis patterns
- Automated health checks
- Slack notifications
- Custom email templates
This project is licensed under the MIT License - see the LICENSE file for details.
- 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.