Rendi MCP Server

🚀 Rendi MCP Server

A Model Context Protocol (MCP) server that offers cloud-based FFmpeg processing capabilities via the Rendi API. This server empowers AI assistants to execute FFmpeg commands in the cloud without local installation or infrastructure.

🚀 Quick Start

The Rendi MCP Server allows AI assistants to run FFmpeg commands in the cloud. To get started, you need a Rendi API key and an MCP-compatible client. Then, you can install the server either via Smithery or manually.

✨ Features

This MCP server offers four potent tools for cloud-based video and audio processing:

🎬 Run FFmpeg Command

Execute a single FFmpeg command in the cloud with automatic file handling and processing. Ideal for simple video conversions, resizing, format changes, and basic editing tasks.

⛓️ Run Chained FFmpeg Commands

Submit multiple sequential FFmpeg commands where the outputs of earlier commands can serve as inputs for later ones. This is perfect for complex workflows such as:

• Convert video → Extract thumbnail → Apply watermark
• Trim video → Resize → Extract audio → Convert to MP3

Chained commands are more efficient than running commands separately as they share system resources.

📊 Poll FFmpeg Command

Check the status of submitted commands and retrieve results, including:

• Processing status (queued, processing, success, failed)
• Execution time and performance metrics
• Output file metadata (resolution, duration, bitrate, codec, etc.)
• Direct download URLs for processed files

🗑️ Delete Command Files

Clean up output files from Rendi's storage after use. This helps manage storage space and keeps your workspace organized.

📚 Documentation

What is Rendi?

Rendi is a cloud-based FFmpeg API service that enables you to run FFmpeg commands without local FFmpeg installation. It provides:

• ☁️ Cloud-based processing infrastructure
• 🚀 Scalable vCPU allocation (up to your account limit)
• 📦 Automatic file storage and management
• 🔒 Secure API key authentication
• ⚡ Fast processing with configurable resources

Prerequisites

• A Rendi API key (get one at rendi.dev)
• An MCP-compatible client (Claude Desktop, Cline, etc.)

Installation

Via Smithery

The simplest way to install this server is through Smithery:

npx @smithery/cli install rendi-mcp-server

You'll be prompted to enter your Rendi API key during installation.

Manual Installation

1. Clone this repository:

git clone https://github.com/ctaylor86/rendi-mcp-server.git
cd rendi-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Configure your MCP client to use this server with your Rendi API key.

Configuration

This server requires one configuration parameter:

• rendiApiKey (required): Your Rendi API key for authentication

Example Configuration for Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "rendi": {
      "command": "node",
      "args": ["/path/to/rendi-mcp-server/dist/index.js"],
      "env": {
        "RENDI_API_KEY": "your-rendi-api-key-here"
      }
    }
  }
}

Usage Examples

Basic Usage

# Use the run_ffmpeg_command tool to convert a video to MP4:
# - Command: "-i {{in_1}} -c:v libx264 -c:a aac {{out_1}}"
# - Input files: {"in_1": "https://example.com/video.avi"}
# - Output files: {"out_1": "converted.mp4"}

Advanced Usage

# Use the run_chained_ffmpeg_commands tool for a multi-step workflow:
# 1. Concatenate two videos
# 2. Extract a thumbnail from the result
# 
# Commands:
# [
#   "-i {{in_1}} -i {{in_2}} -filter_complex \"[0:v][1:v]concat=n=2:v=1:a=0[v]\" -map [v] {{out_1}}",
#   "-i {{out_1}} -ss 00:00:10 -vframes 1 {{out_2}}"
# ]
# 
# Input files: {
#   "in_1": "https://example.com/part1.mp4",
#   "in_2": "https://example.com/part2.mp4"
# }
# 
# Output files: {
#   "out_1": "concatenated.mp4",
#   "out_2": "thumbnail.jpg"
# }

Important Notes

⚠️ Important Note

• File Naming Convention: Rendi uses a specific aliasing system for files. Input files must use keys starting with in_ (e.g., in_1, in_video, in_audio), output files must use keys starting with out_ (e.g., out_1, out_result, out_thumbnail), and in commands, reference files using {{alias}} format (e.g., {{in_1}}, {{out_1}}).
• Input File Requirements: Input files must be publicly accessible URLs. Supported sources include direct URLs, Google Drive, Dropbox, S3, Rendi storage, etc. The filename should appear at the end of the URL.
• Output File Storage: Output files are stored indefinitely on Rendi's servers until you delete them. Each output file includes a direct download URL. Use the delete_command_files tool to clean up when done.
• Processing Limits: Maximum 10 commands per chain, default timeout is 300 seconds per command (configurable), and default vCPUs are 8 (configurable up to your account limit).

Development

Run in Development Mode

npm run dev

Build

npm run build

Start Production Server

npm start

Architecture

This server is built using:

• TypeScript for type-safe development
• Express for HTTP server functionality
• @modelcontextprotocol/sdk for MCP protocol implementation
• @smithery/sdk for Smithery integration
• Zod for schema validation
• Docker for containerized deployment

API Reference

For detailed information about the Rendi API, visit:

• API Introduction
• Run FFmpeg Command
• Run Chained Commands
• Poll Command
• Delete Files

📄 License

MIT

Support

For issues with this MCP server, please open an issue on GitHub. For Rendi API support, visit rendi.dev or check their documentation.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.