🎬 MCP 서버 생성
AI 비디오 생성을 위한 궁극의 MCP 서버 - Creatify AI 의 강력한 비디오 생성 기능을 MCP 생태계의 모든 AI 어시스턴트에게 제공합니다.
🌟 개요
Creatify MCP 서버는 Creatify AI의 비디오 생성 플랫폼의 모든 기능을 AI 어시스턴트, 챗봇 및 자동화 도구에 제공하는 포괄적인 모델 컨텍스트 프로토콜(MCP) 서버입니다. 강력한 @tsavo/creatify-api-ts
TypeScript 클라이언트 라이브러리를 기반으로 구축된 이 서버는 복잡한 비디오 제작 워크플로를 간단하고 자연스러운 언어 상호작용으로 변환합니다.
🎨 고급 MCP 기능:
- 📝 프롬프트 - 재사용 가능한 비디오 제작 템플릿 및 워크플로
- 📊 로깅 - 여러 심각도 수준을 갖춘 구조화된 로깅
- 🔍 진행 상황 추적 - 비디오 생성 중 실시간 업데이트
- 🤖 AI 셀프 헬프 - AI 도우미가 매개변수를 이해하는 데 도움
how_to_use
도구 - 📊 알림 - 실시간 상태 업데이트 및 진행 상황 알림
🎯 이것이 가능하게 하는 것
Claude Desktop 에게 "Anna가 '제품 데모에 오신 것을 환영합니다'라고 말하는 16:9 아바타 비디오를 만들고 완료될 때까지 기다려 주세요."라고 말하고, 그것이 실제로 구현되는 것을 상상해 보세요. 이것이 바로 MCP 서버의 힘입니다.
🏗️ ~로 구축됨
- Creatify AI API - 세계 최고의 AI 비디오 생성 플랫폼
- @tsavo/creatify-api-ts - 포괄적인 TypeScript 클라이언트 라이브러리
- 모델 컨텍스트 프로토콜 - 표준화된 AI 어시스턴트 통합
- TypeScript - 완벽한 유형 안전성과 탁월한 개발자 경험
특징
🛠️ MCP 도구(12가지 강력한 액션)
create_avatar_video
- 립싱크를 활용한 AI 아바타 영상 제작create_url_to_video
- 웹사이트를 전문적인 비디오로 변환generate_text_to_speech
- 텍스트에서 자연스러운 음성 생성create_multi_avatar_conversation
- 여러 아바타가 대화하는 영상을 만듭니다.create_custom_template_video
- 사용자 정의 템플릿을 사용하여 비디오 생성create_ai_edited_video
- 비디오를 자동으로 편집하고 향상시킵니다create_ai_shorts
- 짧은 형식의 비디오를 만듭니다(TikTok, Instagram Reels에 적합)generate_ai_script
- 비디오를 위한 AI 기반 스크립트 생성create_custom_avatar
- 나만의 맞춤형 아바타를 디자인하고 만들어보세요(DYOA)manage_music
- 배경음악 업로드, 관리, 사용create_advanced_lipsync
- 감정 및 제스처 제어가 가능한 고급 립싱크how_to_use
- 모든 도구에 대한 자세한 사용 정보를 얻으세요get_video_status
- 비디오 생성 작업 상태 확인
📚 MCP 리소스(6개 데이터 소스)
creatify://avatars
- 사용 가능한 AI 아바타 목록creatify://voices
- 텍스트 음성 변환에 사용 가능한 음성 목록creatify://templates
- 사용 가능한 사용자 정의 비디오 템플릿creatify://music
- 사용 가능한 배경 음악 라이브러리creatify://credits
- 남은 API 크레딧creatify://avatar/{avatarId}
- 특정 아바타에 대한 자세한 정보
🏆 왜 Creatify MCP 서버를 선택해야 하나요?
🚀 완전한 API 커버리지
- ✅ Creatify API 기능의 100%를 포괄하는 12개의 MCP 도구
- ✅ 포괄적인 데이터 액세스를 위한 6가지 MCP 리소스
- ✅ 일반적인 비디오 제작 시나리오를 위한 5가지 워크플로 프롬프트
- ✅ 8가지 심각도 수준을 갖춘 엔터프라이즈급 로깅
🤖 AI 우선 디자인
- ✅ AI 어시스턴트를 위한
how_to_use
도구를 통한 자체 문서화 - ✅ 지능형 매개변수 검증 및 오류 처리
- ✅ 비디오 생성 중 실시간 진행 상황 업데이트
- ✅ 자동 릴리스를 통한 의미적 버전 관리
🎨 고급 기능
- ✅ 고급 립싱크의 감정 및 제스처 제어
- ✅ 사용자 정의 아바타 생성 (DYOA - 나만의 아바타 디자인)
- ✅ 모든 비디오 유형에 대한 AI 기반 스크립트 생성
- ✅ TikTok/Instagram/YouTube를 위한 단편 영상 최적화
- ✅ 배경음악 관리 및 통합
💼 제작 준비 완료
- ✅ 유형 안전성과 더 나은 IDE 지원을 위한 TypeScript
- ✅ 자세한 컨텍스트를 통한 포괄적인 오류 처리
- ✅ 모니터링 및 디버깅을 위한 전문 로깅
- ✅ 자동화된 테스트 및 지속적인 통합
- ✅ 안정적인 업데이트를 위한 의미적 버전 관리
📝 MCP 프롬프트(5개 워크플로 템플릿)
create-product-demo
- 전문적인 제품 데모 워크플로create-social-content
- 매력적인 소셜 미디어 콘텐츠 제작create-educational-video
- 교육 및 튜토리얼 비디오 워크플로create-marketing-campaign
- 마케팅 캠페인 영상 제작analyze-video-performance
- 비디오 성능 분석 및 최적화
필수 조건
- Node.js 18 이상
- Createtify API 자격 증명(Pro 플랜 이상)
- Creatify 계정 설정 에서 API 자격 증명을 받으세요
설치
npm에서 (권장)
지엑스피1
출처에서
🎬 라이브 데모 예시
AI 아바타 비디오 만들기
TikTok 스타일의 짧은 영상 제작
웹사이트를 비디오로 변환
AI 기반 스크립트 생성
구성
Creatify API 자격 증명을 환경 변수로 설정하세요.
또는 .env
파일을 만듭니다.
용법
클로드 데스크톱과 함께
Claude Desktop 구성에 다음을 추가합니다(macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json
):
🎨 고급 MCP 기능
📝 프롬프트(워크플로 템플릿) 사용
이제 AI 어시스턴트는 일반적인 비디오 제작 시나리오에 미리 정의된 워크플로 템플릿을 사용할 수 있습니다.
예: 제품 데모 워크플로
사용 가능한 프롬프트 템플릿:
create-product-demo
- 전문적인 제품 데모create-social-content
- TikTok/Instagram/YouTube 콘텐츠create-educational-video
- 튜토리얼 및 교육 콘텐츠create-marketing-campaign
- 마케팅 및 홍보 영상analyze-video-performance
- 비디오 최적화 및 분석
📊 실시간 로깅 및 진행 상황
서버는 여러 심각도 수준을 갖춘 구조화된 로깅을 제공합니다.
로그 수준: debug
, info
, notice
, warning
, error
, critical
, alert
, emergency
🤖 AI 셀프헬프 시스템
AI 보조원은 이제 how_to_use
도구를 사용하여 도구 매개변수를 더 잘 이해할 수 있습니다.
사용자 정의 MCP 클라이언트 사용
독립형 서버
AI 어시스턴트를 위한 예시 프롬프트
Claude Desktop이나 다른 MCP 클라이언트로 구성하면 다음과 같은 자연어 프롬프트를 사용할 수 있습니다.
- "Anna가 '제품 데모에 오신 것을 환영합니다'라고 말하는 16:9 아바타 비디오를 만들고 완료될 때까지 기다리세요."
- "웹사이트 https://example.com을 홍보 영상으로 변환하세요"
- "전문가의 음성을 사용하여 'Hello world'에 대한 텍스트 음성 변환 오디오를 생성합니다."
- "사용 가능한 모든 아바타와 세부 정보를 보여주세요"
- "내 남은 Createify 크레딧을 확인하세요"
- "새로운 제품에 대해 논의하는 두 아바타 간의 대화를 만들어 보세요"
API 참조
도구
create_avatar_video
입술 동기화된 음성으로 AI 아바타 비디오를 만들어 보세요.
매개변수:
text
(문자열, 필수) - 말할 텍스트avatarId
(문자열, 필수) - 사용할 아바타 IDaspectRatio
("16:9" | "9:16" | "1:1", 필수) - 비디오 종횡비voiceId
(문자열, 선택 사항) - 아바타의 음성 IDwaitForCompletion
(부울, 선택 사항) - 비디오 완료 대기
create_url_to_video
웹사이트 URL을 전문적인 비디오로 변환합니다.
매개변수:
url
(문자열, 필수) - 변환할 URLvisualStyle
(문자열, 선택 사항) - 시각적 스타일 템플릿scriptStyle
(문자열, 선택 사항) - 스크립트 작성 스타일aspectRatio
("16:9" | "9:16" | "1:1", 선택 사항) - 비디오 종횡비waitForCompletion
(부울, 선택 사항) - 비디오 완료 대기
generate_text_to_speech
텍스트에서 자연스러운 음성을 생성합니다.
매개변수:
text
(문자열, 필수) - 음성으로 변환할 텍스트voiceId
(문자열, 필수) - 사용할 음성 IDwaitForCompletion
(boolean, 선택 사항) - 오디오 완료 대기
get_video_status
비디오 생성 작업의 상태를 확인합니다.
매개변수:
videoId
(문자열, 필수) - 확인할 비디오/작업 IDvideoType
(문자열, 필수) - 작업 유형("립싱크", "url-to-video" 등)
자원
creatify://avatars
ID, 이름, 메타데이터와 함께 사용 가능한 모든 AI 아바타의 JSON 목록을 반환합니다.
creatify://voices
텍스트 음성 생성에 사용할 수 있는 모든 음성의 JSON 목록을 반환합니다.
creatify://templates
사용 가능한 사용자 정의 비디오 템플릿의 JSON 목록을 반환합니다.
creatify://credits
현재 계좌의 신용 잔액과 사용 정보를 반환합니다.
개발
기여하다
- 저장소를 포크하세요
- 기능 브랜치를 생성합니다(
git checkout -b feature/amazing-feature
) - 변경 사항을 커밋하세요(
git commit -m 'Add amazing feature'
) - 브랜치에 푸시(
git push origin feature/amazing-feature
) - 풀 리퀘스트 열기
특허
MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.
관련 프로젝트
@tsavo/creatify-api-ts
- Creatify API용 TypeScript 클라이언트- 모델 컨텍스트 프로토콜 - 프로토콜 사양
- Creatify AI - AI 비디오 생성 플랫폼
📚 포괄적인 문서
🎬 비디오 튜토리얼
곧 출시 - 실제 사용 시나리오를 보여주는 포괄적인 비디오 튜토리얼
📖 API 참조
자세한 API 문서는 다음을 참조하세요.
- Creatify API 문서 - 공식 Creatify API 문서
- @tsavo/creatify-api-ts 문서 - TypeScript 클라이언트 라이브러리 문서
- 모델 컨텍스트 프로토콜 사양 - MCP 프로토콜 세부 정보
🔧 고급 구성
환경 변수
변하기 쉬운 | 필수의 | 설명 | 예 |
---|---|---|---|
CREATIFY_API_ID | ✅ | 귀하의 Createify API ID | your-api-id-here |
CREATIFY_API_KEY | ✅ | 귀하의 Createify API 키 | your-api-key-here |
MCP_LOG_LEVEL | ❌ | 로깅 레벨 | debug , info , warn , error |
Claude Desktop 고급 구성
🚀 성능 최적화
배치 작업
여러 개의 비디오를 제작하는 경우 일괄 처리 기능을 사용하는 것을 고려해 보세요.
캐싱 전략
- 아바타/음성 목록 : 1시간 동안 캐시(거의 변경되지 않음)
- 비디오 상태 : 활성 작업에 대해 5~10초마다 폴링
- 템플릿 : 24시간 동안 캐시
🔐 보안 모범 사례
- API 키를 버전 제어에 커밋하지 마십시오.
- 모든 민감한 데이터에 환경 변수를 사용하세요
- API 키를 정기적으로 회전하세요
- 무단 액세스를 감지하기 위해 API 사용을 모니터링합니다.
- 모든 웹훅 URL에 HTTPS를 사용하세요
🐛 문제 해결
일반적인 문제
"API 자격 증명을 찾을 수 없습니다"
"비디오 생성에 실패했습니다."
- Creatify 계정 크레딧을 확인하세요
- 아바타/음성 ID가 있는지 확인하세요
- 텍스트가 비어 있지 않은지 확인하세요
- 종횡비가 유효한지 확인하세요
"MCP 연결에 실패했습니다."
- 서버가 실행 중인지 확인하세요
- Claude Desktop 구성 확인
- Node.js 버전 >= 18을 확인하세요.
디버그 모드
📊 모니터링 및 분석
사용 추적
Createfy API 사용량을 모니터링하세요.
성과 지표
- 영상 제작 시간 : 일반적으로 2~5분
- API 응답 시간 : 일반적으로 < 2초
- 성공률 : 실패한 요청 모니터링
🤝 기여하기
여러분의 참여를 환영합니다! 시작하는 방법은 다음과 같습니다.
🛠️ 개발 설정
🧪 테스트
📝 코드 스타일
우리는 다음을 사용합니다:
- 코드 린팅을 위한 ESLint
- 코드 포맷팅에 더 좋음
- 유형 안전을 위한 TypeScript
- 커밋 메시지에 대한 기존 커밋
🔄 풀 리퀘스트 프로세스
- 저장소를 포크하세요
- 기능 브랜치를 생성합니다(
git checkout -b feature/amazing-feature
) - 변경 사항을 만드세요
- 새로운 기능에 대한 테스트 추가
- 모든 테스트가 통과되었는지 확인하세요(
npm test
) - 린팅 실행(
npm run lint:fix
) - 변경 사항을 커밋합니다(
git commit -m 'feat: add amazing feature'
) - 브랜치에 푸시(
git push origin feature/amazing-feature
) - 풀 리퀘스트 열기
📄 라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
🙏 감사의 말
- Creatify AI - 놀라운 AI 비디오 생성 플랫폼 제공
- @tsavo/creatify-api-ts - 이 서버를 구동하는 강력한 TypeScript 클라이언트 라이브러리
- Anthropic - Claude와 모델 컨텍스트 프로토콜을 위해
- MCP 커뮤니티 - 이 통합을 가능하게 하는 표준화된 프로토콜을 위해
📞 지원
- 📖 Creatify API 문서 - 공식 API 문서
- 🐛 문제 보고 - 버그 보고 및 기능 요청
- 💬 MCP 커뮤니티 - 커뮤니티 토론
- 📧 저자에게 문의하기 - 직접 지원
T Savo 가 ❤️로 만들었습니다
🌐 호라이즌 시티 - AI 혁명을 선도하고 인류 멸종을 앞당기다
모든 개발자와 AI 지원자가 AI 비디오 생성에 접근할 수 있도록 하여 인간의 쓸모없음에 한 걸음 더 다가가다
Related MCP Servers
- PythonApache 2.0
- JavaScript
- PythonMIT License
- TypeScript