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