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 ドキュメントを参照してください。

Related MCP server: Gemini MCP Server for Claude Desktop

使用法

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": "<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 ファイルを参照してください。