Heygen MCP 서버

HeyGen MCP 서버를 사용하면 Claude Desktop이나 Agents와 같은 모든 MCP 클라이언트가 HeyGen API를 사용하여 아바타와 비디오를 생성할 수 있습니다.

참고: 이 프로젝트는 초기 개발 단계에 있습니다. 커뮤니티의 피드백과 기여를 환영하지만, 공식적인 지원은 제한되어 있습니다.

설치

필수 조건

Python 3.10 이상
Heygen API 키( Heygen 에서 제공). 월 10개의 무료 크레딧 포함

UV 설치

uv는 이 패키지를 설치하는 데 권장하는 빠른 Python 패키지 설치 및 확인 프로그램입니다.

macOS 또는 Linux:

지엑스피1

윈도우:

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

# Or via 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": "<insert-your-api-key-here>"
      }
    }
  }
}

Windows를 사용하는 경우, MCP 서버를 사용하려면 Claude Desktop에서 "개발자 모드"를 활성화해야 합니다. 왼쪽 상단의 햄버거 메뉴에서 "도움말"을 클릭하고 "개발자 모드 활성화"를 선택하세요.

사용 가능한 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 검사기를 사용하여 사용 가능한 도구와 기능을 테스트할 수 있습니다.

로드맵

[ ] 테스트
[ ] CICD
[ ] 사진 아바타 API 지원
[ ] OAuth Flow를 사용한 SSE 및 원격 MCP 서버
[ ] 번역 API 지원
[ ] 템플릿 API 지원
[ ] 대화형 아바타 API 지원

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.