Servidor MCP de Heygen

El servidor MCP de HeyGen permite que cualquier cliente MCP, como Claude Desktop o Agents, utilice la API de HeyGen para generar avatares y vídeos.

Nota: Este proyecto se encuentra en una etapa inicial de desarrollo. Si bien agradecemos los comentarios y contribuciones de la comunidad, tenga en cuenta que el soporte oficial es limitado.

Instalación

Prerrequisitos

Python 3.10 o superior
Una clave API de Heygen (consíguela en Heygen ). Incluye 10 créditos gratis al mes.

Instalación de uv

uv es un instalador y solucionador rápido de paquetes de Python que recomendamos para instalar este paquete.

macOS o Linux:

# Install with the official installer script
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or via Homebrew (macOS)
brew install uv

Ventanas:

# Install with the official installer script in PowerShell
irm https://astral.sh/uv/install.ps1 | iex

# Or via Scoop
scoop install uv

Para otros métodos de instalación, consulte la documentación de uv .

Uso

Inicio rápido con Claude Desktop

Obtén tu clave API de HeyGen .
Instale el administrador de paquetes uv (consulte la sección Instalación de uv más arriba).
Vaya a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json para incluir lo siguiente:

{
  "mcpServers": {
    "HeyGen": {
      "command": "uvx",
      "args": ["heygen-mcp"],
      "env": {
        "HEYGEN_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

Si usa Windows, deberá habilitar el "Modo de desarrollador" en Claude Desktop para usar el servidor MCP. Haga clic en "Ayuda" en el menú de la esquina superior izquierda y seleccione "Habilitar modo de desarrollador".

Herramientas MCP disponibles

El servidor proporciona las siguientes herramientas a Claude:

get_remaining_credits : recupera los créditos restantes en su cuenta Heygen.
get_voices : recupera una lista de voces disponibles de la API de Heygen (limitada a las primeras 100 voces).
get_avatar_groups : recupera una lista de grupos de avatares de Heygen.
get_avatars_in_avatar_group : recupera una lista de avatares en un grupo de avatares Heygen específico.
generate_avatar_video : genera un nuevo video de avatar con el avatar, el texto y la voz especificados.
get_avatar_video_status : recupera el estado de un vídeo generado a través de la API de Heygen.

Desarrollo

Ejecutando con MCP Inspector

Para ejecutar el servidor localmente con el Inspector MCP para realizar pruebas y depuraciones:

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

Esto iniciará el servidor en modo de desarrollo y le permitirá utilizar el Inspector MCP para probar las herramientas y funcionalidades disponibles.

Hoja de ruta

[ ] Pruebas
[ ] CICD
[ ] Compatibilidad con API de avatar de foto
[ ] SSE y servidor MCP remoto con flujo OAuth
[ ] Compatibilidad con API de traducción
[ ] Compatibilidad con API de plantillas
[ ] Compatibilidad con API de avatar interactivo

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.