Heygen MCP 服务器

HeyGen MCP 服务器允许任何 MCP 客户端（如 Claude Desktop 或 Agents）使用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，则需要在 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 测试可用的工具和功能。

路线图

[ ] 测试
[ ] 持续集成与持续开发
[ ] 照片头像 API 支持
[ ] SSE 和带有 OAuth 流程的远程 MCP 服务器
[ ] 翻译 API 支持
[ ] 模板 API 支持
[ ] 交互式头像 API 支持

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。