Rendi MCP Server

🚀 Rendi MCP 服務器

Rendi MCP 服務器是一個模型上下文協議（MCP）服務器，它通過 Rendi API 提供基於雲的 FFmpeg 處理能力。該服務器使 AI 助手能夠在雲端運行 FFmpeg 命令，而無需進行本地安裝或搭建基礎設施。

✨ 主要特性

此 MCP 服務器為基於雲的視頻和音頻處理提供了四個強大的工具：

🎬 運行 FFmpeg 命令

在雲端執行單個 FFmpeg 命令，並自動處理和管理文件。非常適合簡單的視頻轉換、調整大小、格式更改和基本編輯任務。

⛓️ 運行鏈式 FFmpeg 命令

提交多個順序執行的 FFmpeg 命令，其中早期命令的輸出可以作為後期命令的輸入。這對於複雜的工作流程非常理想，例如：

• 轉換視頻 → 提取縮略圖 → 添加水印
• 裁剪視頻 → 調整大小 → 提取音頻 → 轉換為 MP3

鏈式命令比單獨運行命令更高效，因為它們可以共享系統資源。

📊 輪詢 FFmpeg 命令

檢查已提交命令的狀態並獲取結果，包括：

• 處理狀態（排隊、處理中、成功、失敗）
• 執行時間和性能指標
• 輸出文件元數據（分辨率、時長、比特率、編解碼器等）
• 處理後文件的直接下載 URL

🗑️ 刪除命令文件

當你完成處理後，清理 Rendi 存儲中的輸出文件。這有助於管理存儲空間並保持工作區的整潔。

📚 什麼是 Rendi？

Rendi 是一個基於雲的 FFmpeg API 服務，允許你在不進行本地安裝的情況下運行 FFmpeg 命令。它提供：

• ☁️ 基於雲的處理基礎設施
• 🚀 可擴展的 vCPU 分配（最高可達你的賬戶限制）
• 📦 自動文件存儲和管理
• 🔒 安全的 API 密鑰認證
• ⚡ 可配置資源的快速處理

📦 安裝指南

通過 Smithery 安裝

通過 Smithery 安裝此服務器是最簡單的方法：

npx @smithery/cli install rendi-mcp-server

安裝過程中會提示你輸入 Rendi API 密鑰。

手動安裝

1. 克隆此倉庫：

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

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 配置你的 MCP 客戶端以使用此服務器，並提供你的 Rendi API 密鑰。

💻 使用示例

基礎用法

簡單視頻轉換

使用 run_ffmpeg_command 工具將視頻轉換為 MP4：
- 命令："-i {{in_1}} -c:v libx264 -c:a aac {{out_1}}"
- 輸入文件：{"in_1": "https://example.com/video.avi"}
- 輸出文件：{"out_1": "converted.mp4"}

從視頻中提取縮略圖

使用 run_ffmpeg_command 工具提取縮略圖：
- 命令："-i {{in_1}} -ss 00:00:05 -vframes 1 {{out_1}}"
- 輸入文件：{"in_1": "https://example.com/video.mp4"}
- 輸出文件：{"out_1": "thumbnail.jpg"}

高級用法

鏈式命令的複雜工作流程

使用 run_chained_ffmpeg_commands 工具進行多步驟工作流程：
1. 拼接兩個視頻
2. 從結果中提取縮略圖

命令：
[
  "-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}}"
]

輸入文件：{
  "in_1": "https://example.com/part1.mp4",
  "in_2": "https://example.com/part2.mp4"
}

輸出文件：{
  "out_1": "concatenated.mp4",
  "out_2": "thumbnail.jpg"
}

檢查命令狀態

提交命令後，使用 poll_ffmpeg_command 和返回的 command_id 檢查狀態並獲取結果。

清理文件

當你完成對輸出文件的處理後，使用 delete_command_files 和 command_id 釋放存儲空間。

🔧 技術細節

重要提示

文件命名約定

Rendi 對文件使用特定的別名系統：

• 輸入文件：鍵名必須以 in_ 開頭（例如，in_1、in_video、in_audio）
• 輸出文件：鍵名必須以 out_ 開頭（例如，out_1、out_result、out_thumbnail）
• 在命令中：使用 {{alias}} 格式引用文件（例如，{{in_1}}、{{out_1}}）

輸入文件要求

• 輸入文件必須是公開可訪問的 URL
• 支持的來源：直接 URL、Google Drive、Dropbox、S3、Rendi 存儲等
• 文件名應出現在 URL 的末尾

輸出文件存儲

• 輸出文件將無限期存儲在 Rendi 的服務器上，直到你刪除它們
• 每個輸出文件都包含一個直接下載 URL
• 使用 delete_command_files 工具在完成處理後進行清理

處理限制

• 每個鏈式命令最多 10 個命令
• 默認超時時間：每個命令 300 秒（可配置）
• 默認 vCPU 數量：8 個（可根據你的賬戶限制進行配置）

開發相關

在開發模式下運行

npm run dev

構建項目

npm run build

啟動生產服務器

npm start

架構信息

此服務器使用以下技術構建：

• TypeScript 用於類型安全的開發
• Express 用於 HTTP 服務器功能
• @modelcontextprotocol/sdk 用於 MCP 協議實現
• @smithery/sdk 用於 Smithery 集成
• Zod 用於模式驗證
• Docker 用於容器化部署

📄 API 文檔

有關 Rendi API 的詳細信息，請訪問：

• API 介紹
• 運行 FFmpeg 命令
• 運行鏈式命令
• 輪詢命令
• 刪除文件

📄 許可證

本項目採用 MIT 許可證。

支持與貢獻

支持

如果你在使用此 MCP 服務器時遇到問題，請在 GitHub 上提交問題。

如需 Rendi API 支持，請訪問 rendi.dev 或查看其 文檔。

貢獻

歡迎貢獻代碼！請隨時提交拉取請求。