Tavus MCP

🚀 Tavus MCP Server

Tavus API用の包括的なモデルコンテキストプロトコル（MCP）サーバーです。MCP互換アプリケーションを通じて、AIビデオ生成、レプリカ管理、会話型AI、リップシンク、音声合成を可能にします。

🚀 クイックスタート

このTavus MCP Serverを使用することで、様々なAI関連の機能を利用できます。以下の説明を参考に、セットアップと使用を行ってください。

✨ 主な機能

🎭 Phoenix Replicas (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 - 既存の音声の名前を変更します。

📦 インストール

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"

APIのカバレッジ

このMCPサーバーは、Tavus API v2を完全にカバーしており、以下の機能を提供します。

• Phoenix Replicas：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 Documentation
• 問題報告：GitHub Issues
• MCPプロトコル：Model Context Protocol

📝 変更履歴

v0.1.0

• 最初のリリース
• Tavus API v2の完全なカバレッジ
• 5つのカテゴリーにまたがる25のツール
• TypeScriptによる実装
• 包括的なエラーハンドリング