Heygen MCP 服务器

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

路线图

• [ ] 测试
• [ ] CICD
• [ ] 照片头像 API 支持
• [ ] 带有 OAuth 流程的 SSE 和远程 MCP 服务器
• [ ] 翻译 API 支持
• [ ] 模板 API 支持
• [ ] 交互式头像 API 支持

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。