🚀 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 快速入门
- 从 Heygen 获取您的 API 密钥。
- 安装 uv 包管理器（参见上面的 安装 uv 部分）。
- 转到 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 文件。
