Heygen MCP 服务器

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

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

安装

前提条件

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

安装 uv

uv 是一个快速的 Python 包安装器和解析器，我们推荐使用它来安装此包。

macOS 或 Linux:

bash

使用官方安装脚本进行安装

curl -LsSf https://astral.sh/uv/install.sh | sh

或者通过 Homebrew (macOS)

brew install uv

Windows:

powershell

在 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 并包含以下内容：

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 本地运行服务器以进行测试和调试：

bash
uv --with "mcp[cli]" dev heygen_mcp/server.py

这将以开发模式启动服务器，并允许您使用 MCP Inspector 测试可用的工具和功能。

路线图

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

贡献

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

许可证

此项目根据 MIT 许可证许可 - 详情请参见 LICENSE 文件。