Heygen MCP Server

Heygen MCP サーバー

HeyGen MCP サーバーを使用すると、Claude Desktop や Agents などの MCP クライアントがHeyGen APIを使用してアバターやビデオを生成できるようになります。

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

インストール

前提条件

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

uvのインストール

uv は、このパッケージのインストールに推奨される高速な Python パッケージ インストーラーおよびリゾルバーです。

macOS または Linux:

ウィンドウズ:

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

使用法

Claude Desktop のクイックスタート

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

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

利用可能な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 を使用してサーバーをローカルで実行するには:

これにより、サーバーが開発モードで起動し、MCP インスペクターを使用して利用可能なツールと機能をテストできるようになります。

ロードマップ

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

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

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