Heygen MCP サーバー

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

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

インストール

前提条件

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

uvのインストール

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

macOS または Linux:

# Install with the official installer script
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or via Homebrew (macOS)
brew install uv

ウィンドウズ:

# Install with the official installer script in PowerShell
irm https://astral.sh/uv/install.ps1 | iex

# Or via Scoop
scoop install uv

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

使用法

Claude Desktop のクイックスタート

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

{
  "mcpServers": {
    "HeyGen": {
      "command": "uvx",
      "args": ["heygen-mcp"],
      "env": {
        "HEYGEN_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

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

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

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

ロードマップ

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

貢献

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

ライセンス

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