Tavus MCP

🚀 Tavus MCP Server

Tavus MCP Server 是一個全面的模型上下文協議（MCP）服務器，專為 Tavus API 設計。它支持通過與 MCP 兼容的應用程序實現 AI 視頻生成、副本管理、對話式 AI、唇形同步和語音合成等功能。

✨ 主要特性

🎭 鳳凰副本（5 個工具）

• create_replica - 從訓練視頻創建新的 AI 副本
• get_replica - 獲取特定副本的詳細信息
• list_replicas - 列出您賬戶中的所有副本
• delete_replica - 永久刪除一個副本
• rename_replica - 重命名現有副本

🎬 視頻生成（5 個工具）

• generate_video - 使用副本結合文本腳本或音頻文件生成視頻
• get_video - 獲取特定視頻的詳細信息
• list_videos - 列出您賬戶中的所有視頻
• delete_video - 永久刪除一個視頻
• rename_video - 重命名現有視頻

💬 對話式 AI（5 個工具）

• create_conversation - 創建交互式視頻對話
• get_conversation - 獲取特定對話的詳細信息
• list_conversations - 列出您賬戶中的所有對話
• end_conversation - 結束一個活躍的對話
• delete_conversation - 永久刪除一個對話

👤 角色（5 個工具）

• create_persona - 為對話式 AI 創建新的角色
• get_persona - 獲取特定角色的詳細信息
• list_personas - 列出您賬戶中的所有角色
• patch_persona - 使用 JSON 補丁格式更新一個角色
• delete_persona - 永久刪除一個角色

🎵 唇形同步（4 個工具）

• create_lipsync - 將音頻與現有視頻進行同步
• get_lipsync - 獲取特定唇形同步的詳細信息
• list_lipsyncs - 列出您賬戶中的所有唇形同步
• delete_lipsync - 永久刪除一個唇形同步

🗣️ 語音合成（5 個工具）

• generate_speech - 使用副本從文本生成語音音頻
• get_speech - 獲取特定語音的詳細信息
• list_speeches - 列出您賬戶中的所有語音
• delete_speech - 永久刪除一個語音
• rename_speech - 重命名現有語音

📦 安裝指南

前提條件

• Node.js 18+
• 一個 Tavus API 密鑰（可在 platform.tavus.io 獲取）

通過 Smithery 安裝

要通過 Smithery 自動為 Claude Desktop 安裝 tavus-mcp，請執行以下命令：

npx -y @smithery/cli install @rakeshdavid/tavus-mcp --client claude

選項 1：使用 NPM 包（推薦）

npm install -g tavus-mcp

選項 2：從源代碼安裝

git clone https://github.com/rakeshdavid/Tavus-MCP.git
cd Tavus-MCP
npm install
npm run build

🔧 配置

環境變量

將您的 Tavus API 密鑰設置為環境變量：

export TAVUS_API_KEY="your_tavus_api_key_here"

MCP 客戶端配置

Claude Desktop

添加到您的 Claude Desktop 配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "tavus-mcp": {
      "command": "npx",
      "args": ["tavus-mcp"],
      "env": {
        "TAVUS_API_KEY": "your_tavus_api_key_here"
      }
    }
  }
}

Cline（VS Code 擴展）

添加到您的 Cline MCP 設置中：

{
  "mcpServers": {
    "tavus-mcp": {
      "command": "npx",
      "args": ["tavus-mcp"],
      "env": {
        "TAVUS_API_KEY": "your_tavus_api_key_here"
      },
      "disabled": false
    }
  }
}

其他 MCP 客戶端

對於其他與 MCP 兼容的應用程序，請使用：

npx tavus-mcp

並設置 TAVUS_API_KEY 環境變量。

💻 使用示例

配置完成後，您可以通過 MCP 客戶端使用 Tavus 工具：

列出您的副本

"Can you list my Tavus replicas?"

生成一個視頻

"Generate a video using replica 'Luna' with the script: 'Hello, welcome to our product demo!'"

創建一個對話式 AI

"Create a new conversational AI persona using my replica for customer support"

為視頻進行唇形同步

"Create a lipsync video using this video URL and this audio URL"

📚 詳細文檔

此 MCP 服務器全面覆蓋了 Tavus API v2，包括：

• 鳳凰副本：AI 視頻副本的完整 CRUD 操作
• 視頻生成：支持文本到視頻和音頻到視頻的生成，並具備高級定製功能
• 對話式 AI：支持交互式視頻對話和角色管理
• 唇形同步：將音頻與現有視頻進行同步
• 語音合成：使用副本進行文本到語音的生成

🔧 技術細節

開發設置

git clone https://github.com/rakeshdavid/Tavus-MCP.git
cd Tavus-MCP
npm install

構建項目

npm run build

開發時自動重建

npm run watch

測試

設置您的 API 密鑰並測試服務器：

export TAVUS_API_KEY="your_api_key"
npm run inspector

MCP 檢查器將提供一個 URL，您可以在瀏覽器中測試服務器。

錯誤處理

服務器包含全面的錯誤處理機制：

• 身份驗證錯誤：API 密鑰無效
• 速率限制：API 速率限制超出
• 支付錯誤：信用額度不足（402 狀態）
• 驗證錯誤：參數無效
• 網絡錯誤：連接問題

🤝 貢獻指南

1. 分叉倉庫
2. 創建一個功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add amazing feature')
4. 推送到該分支 (git push origin feature/amazing-feature)
5. 打開一個拉取請求

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

🛠️ 支持

• 文檔：Tavus API 文檔
• 問題反饋：GitHub 問題
• MCP 協議：模型上下文協議

📝 更新日誌

v0.1.0

• 初始版本發佈
• 全面覆蓋 Tavus API v2
• 涵蓋 5 個類別共 25 個工具
• 使用 TypeScript 實現
• 包含全面的錯誤處理機制