https://github.com/patrickkalkman/encoding-devops
MCP Encoding DevOps
https://github.com/patrickkalkman/encoding-devops
mcp-server model-context-protocol
Last synced: 7 months ago
JSON representation
MCP Encoding DevOps
- Host: GitHub
- URL: https://github.com/patrickkalkman/encoding-devops
- Owner: PatrickKalkman
- License: mit
- Created: 2025-02-17T20:29:40.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-02-22T19:17:46.000Z (8 months ago)
- Last Synced: 2025-03-09T02:51:29.661Z (7 months ago)
- Topics: mcp-server, model-context-protocol
- Language: Python
- Homepage:
- Size: 203 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎬 Encoding DevOps MCP Server: AI-Powered Video Encoding Assistant
[](https://github.com/PatrickKalkman/encoding-devops/stargazers)
[](https://github.com/PatrickKalkman/encoding-devops/graphs/contributors)
[](https://github.com/PatrickKalkman/encoding-devops)
[](https://github.com/PatrickKalkman/encoding-devops/issues)
[](https://www.python.org/downloads/)
[](https://makeapullrequest.com)
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
## 🚀 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
1. **Install the package using UV**:
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install encoding-devops
```
2. **Set up your environment**:
```bash
# Copy the example config
cp .env.example .env
# Add your API keys
nano .env
```
3. **Register with Claude Desktop**:
```bash
uv run mcp install ./src/encoding_devops/main.py
```
## 💡 How to Use It
```bash
# 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:
1. **Resources**: Email templates, error guides, and documentation
2. **Tools**: Job status checks, log analysis, and email drafting
3. **Prompts**: Instructions that help Claude understand encoding issues
## 🤝 Want to Help?
We'd love your input! Here's how you can contribute:
1. Fork it
2. Create your feature branch (`git checkout -b feature/awesome-feature`)
3. Commit your changes (`git commit -m 'Add awesome feature'`)
4. Push to the branch (`git push origin feature/awesome-feature`)
5. 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](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](https://medium.com/p/dedab6dc182b).*