Heygen MCP

🚀 Heygen MCP 服务器

Heygen MCP 服务器允许任何 MCP 客户端（如 Claude Desktop 或代理）借助 Heygen API 生成头像和视频，为头像与视频生成提供了便捷途径。

⚠️ 重要提示

该项目仍处于早期开发阶段。尽管我们欢迎社区的反馈和贡献，但请注意官方支持有限。

🚀 快速开始

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