heygen-mcp-adapter

HeyGen MCP Adapter

This project provides a simple REST API for generating videos through HeyGen and checking their status.

Running Locally

1. Install dependencies:

   pip install -r requirements.txt
   

2. Set your HeyGen API credentials as environment variables:

   export HEYGEN_API_KEY=<your-api-key>
   # optional: override base URL if needed
   export HEYGEN_BASE_URL=https://api.heygen.com/v1
   

3. Start the server:

   uvicorn server:app --reload
   

The API will be available at http://localhost:8000. Video metadata is stored in a local SQLite database (videos.db) created automatically in the project directory.

Refer to openapi.yaml for the API specification.

Authentication

Set the API_TOKEN environment variable to define the token expected by the server (defaults to dev-token). Requests to /video/generate and /video/{video_id}/status must include this token using the Authorization header:

curl -H "Authorization: Bearer $API_TOKEN" http://localhost:8000/video/generate
=======
## Docker

To build and run the application using Docker:

```bash
docker build -t heygen-mcp-adapter .
docker run -p 8000:8000 heygen-mcp-adapter

Using Docker Compose

For development with automatic reloads:

docker-compose up --build