Heygen MCP

🚀 Heygen MCP サーバー

Heygen MCP サーバーは、任意の MCP クライアント（Claude Desktop やプロキシなど）が Heygen API を通じてアバターとビデオを生成できるようにします。

⚠️ 重要提示

このプロジェクトはまだ開発の初期段階です。コミュニティからのフィードバックや貢献を歓迎しますが、公式のサポートは限られていることにご注意ください。

📦 インストール

前提条件

• Python 3.10 以上
• Heygen API キー（Heygen から取得）。月に 10 回の無料クレジットが含まれます。

uv のインストール

uv は高速な Python パッケージインストーラーと解析器です。このパッケージをインストールする際には、uv の使用をおすすめします。

macOS または Linux：

# 公式インストールスクリプトを使用してインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# または Homebrew（macOS）を使用
brew install uv

Windows：

# PowerShell で公式インストールスクリプトを使用
irm https://astral.sh/uv/install.ps1 | iex

# または Scoop を使用
scoop install uv

その他のインストール方法については、uv ドキュメント を参照してください。

💻 使用例

Claude Desktop でのクイックスタート

1. Heygen から API キーを取得します。
2. uv パッケージマネージャーをインストールします（上記の uv のインストール セクションを参照）。
3. Claude > 設定 > 開発者 > 設定の編集 > claude_desktop_config.json に移動し、以下の内容を追加します。

{
  "mcpServers": {
    "HeyGen": {
      "command": "uvx",
      "args": ["heygen-mcp"],
      "env": {
        "HEYGEN_API_KEY": "<ここにあなたの API キーを挿入>"
      }
    }
  }
}

Windows を使用している場合は、Claude Desktop で「開発者モード」を有効にして MCP サーバーを使用できるようにしてください。メニューバーの左側にあるハンバーガーメニューをクリックし、「ヘルプ」を選択してから「開発者モードを有効にする」を選択します。

利用可能な MCP ツール

このサーバーは、Claude 用に以下のツールを提供します。

• get_remaining_credits：Heygen アカウントの残りクレジットを取得します。
• get_voices：Heygen API から利用可能な音声のリストを取得します（上位 100 音声まで）。
• get_avatar_groups：Heygen アバターグループのリストを取得します。
• get_avatars_in_avatar_group：特定の Heygen アバターグループ内のアバターのリストを取得します。
• generate_avatar_video：指定したアバター、テキスト、音声を使用して新しいアバタービデオを生成します。
• get_avatar_video_status：Heygen API を通じて生成されたビデオのステータスを取得します。

🔧 開発

MCP Inspector を使用して実行

MCP Inspector を使用してサーバーをローカルでテストおよびデバッグするには、以下のコマンドを実行します。

uv --with "mcp[cli]" dev heygen_mcp/server.py

これにより、サーバーが開発モードで起動し、MCP Inspector を使用して利用可能なツールとその機能をテストできます。

📈 ロードマップ

• [ ] テスト
• [ ] CI/CD
• [ ] 写真アバター API のサポート
• [ ] SSE とリモート MCP サーバーの OAuth フローのサポート
• [ ] 翻訳 API のサポート
• [ ] テンプレート API のサポート
• [ ] インタラクティブアバター API のサポート

👥 貢献

貢献を歓迎します！自由に Pull Request を提出してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。