기능 개요
Veo MCP Server는 다음과 같은 핵심 기능을 제공합니다:- 텍스트 생성 비디오 — 텍스트 프롬프트를 통해 고품질 비디오 생성
- 이미지 생성 비디오 — 이미지를 기반으로 비디오 생성
- 다중 모델 지원 — veo3, veo2, veo31-fast-ingredient 등 모델 지원
- 다양한 해상도 — 4K, 1080p, GIF 등 출력 형식 지원
- 다양한 화면 비율 — 16:9, 9:16 등 비율 지원
- 1080p 업그레이드 — 생성된 비디오를 1080p로 업그레이드
- 작업 조회 — 생성 진행 상황 모니터링 및 결과 획득
전제 준비
사용하기 전에 AceData Cloud API Token을 획득해야 합니다:- AceData Cloud 플랫폼에서 등록 또는 로그인
- Veo Videos API 페이지로 이동
- 「Acquire」를 클릭하여 API Token을 획득 (첫 신청 시 무료 크레딧 제공)
설치 구성
방법 1: pip 설치 (추천)
방법 2: 소스 코드 설치
mcp-veo 명령어로 서비스를 시작할 수 있습니다.
Claude Desktop에서 사용하기
Claude Desktop 구성 파일을 편집합니다:- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
uvx를 사용하는 경우(사전 패키지 설치 필요 없음):
VS Code / Cursor에서 사용하기
프로젝트 루트 디렉토리에.vscode/mcp.json을 생성합니다:
uvx를 사용할 수 있습니다:
사용 가능한 도구 목록
| 도구명 | 설명 |
|---|---|
veo_text_to_video | 텍스트 프롬프트를 통해 비디오 생성 |
veo_image_to_video | 이미지를 기반으로 비디오 생성 |
veo_get_1080p | 비디오를 1080p로 업그레이드 |
veo_get_task | 단일 작업 상태 조회 |
veo_get_tasks_batch | 배치 작업 상태 조회 |
사용 예시
구성이 완료되면 AI 클라이언트에서 자연어로 이러한 기능을 직접 호출할 수 있습니다, 예를 들어:- 「Veo를 사용하여 별이 빛나는 하늘의 타임랩스 비디오를 생성해줘」
- 「이 풍경 사진으로 4K 비디오를 생성해줘」
- 「세로 9:16의 짧은 비디오를 생성해줘」
- 「이 비디오를 1080p로 업그레이드해줘」
추가 정보
- GitHub 저장소: AceDataCloud/MCPVeo
- PyPI 패키지: mcp-veo
- API 문서: Veo 비디오 생성 API

