金大哥 - tavus-mcp MCP 详情

article

README

🚀 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 状态）
验证错误：参数无效
网络错误：连接问题

🤝 贡献指南

分叉仓库
创建一个功能分支 (git checkout -b feature/amazing-feature)
提交您的更改 (git commit -m 'Add amazing feature')
推送到该分支 (git push origin feature/amazing-feature)
打开一个拉取请求

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🛠️ 支持

文档：Tavus API 文档
问题反馈：GitHub 问题
MCP 协议：模型上下文协议

📝 更新日志

v0.1.0

初始版本发布
全面覆盖 Tavus API v2
涵盖 5 个类别共 25 个工具
使用 TypeScript 实现
包含全面的错误处理机制