Heygen MCP Server

HeyGen MCP服务器使任何MCP客户端（如Claude Desktop或代理）能够使用HeyGen API生成头像和视频。

注意：此项目尚处于早期开发阶段。虽然我们欢迎社区反馈和贡献，请注意官方支持有限。

安装

先决条件

• Python 3.10 或更高版本
• 一个HeyGen API密钥（从HeyGen获取）。每月包含10个免费积分

安装uv

uv是一个快速的Python包安装程序和解析器，我们推荐用于安装此包。

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文件。