🎬 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 - 완벽한 유형 안전성과 탁월한 개발자 경험

Related MCP server: Clockify MCP

특징

🛠️ 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

출처에서

git clone https://github.com/TSavo/creatify-mcp.git
cd creatify-mcp
npm install
npm run build
npm link

🎬 라이브 데모 예시

AI 아바타 비디오 만들기

User: "Create a professional avatar video with Anna saying 'Welcome to our company!' in 16:9 format"

Claude: I'll create a professional avatar video for you using the Creatify MCP Server.

[Uses create_avatar_video tool with:
- text: "Welcome to our company!"
- avatarId: "anna_costume1_cameraA"
- aspectRatio: "16:9"
- voiceId: "en-US-AriaNeural"]

Your professional avatar video has been created! Anna delivers your message with natural lip-sync and professional presentation.

TikTok 스타일의 짧은 영상 제작

User: "Make a 30-second TikTok video about coffee brewing tips"

Claude: I'll create an engaging short-form video perfect for TikTok!

[Uses create_ai_shorts tool with:
- prompt: "Quick coffee brewing tips with energetic presentation"
- aspectRatio: "9:16"
- duration: 30
- style: "energetic"]

Your TikTok-ready short video is being generated with optimal 9:16 aspect ratio and engaging content!

웹사이트를 비디오로 변환

User: "Turn my product landing page into a marketing video"

Claude: I'll convert your website into a compelling marketing video.

[Uses create_url_to_video tool with:
- url: "https://yourproduct.com"
- aspectRatio: "16:9"
- style: "marketing"]

Your landing page has been transformed into a professional marketing video showcasing your product!

AI 기반 스크립트 생성

User: "Generate a script for a 60-second product demo video"

Claude: I'll create a compelling script for your product demo.

[Uses generate_ai_script tool with:
- topic: "Product demonstration video"
- scriptType: "commercial"
- duration: 60
- tone: "professional"]

Your script is ready! It includes engaging hooks, clear value propositions, and a strong call-to-action optimized for 60-second format.

구성

Creatify API 자격 증명을 환경 변수로 설정하세요.

export CREATIFY_API_ID="your-api-id"
export CREATIFY_API_KEY="your-api-key"

또는 .env 파일을 만듭니다.

CREATIFY_API_ID=your-api-id
CREATIFY_API_KEY=your-api-key

용법

클로드 데스크톱과 함께

Claude Desktop 구성에 다음을 추가합니다(macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json ):

{
  "mcpServers": {
    "creatify": {
      "command": "creatify-mcp",
      "env": {
        "CREATIFY_API_ID": "your-api-id",
        "CREATIFY_API_KEY": "your-api-key"
      }
    }
  }
}

🎨 고급 MCP 기능

📝 프롬프트(워크플로 템플릿) 사용

이제 AI 어시스턴트는 일반적인 비디오 제작 시나리오에 미리 정의된 워크플로 템플릿을 사용할 수 있습니다.

예: 제품 데모 워크플로

User: "Use the create-product-demo prompt for 'Amazing Widget' with features 'fast, reliable, easy to use' targeting small business owners"

Claude: I'll use the product demo workflow template to create a professional demonstration video.

[Claude automatically follows the complete workflow:
1. Generates an engaging script using generate_ai_script
2. Creates avatar video using create_avatar_video
3. Optimizes for the target audience
4. Includes clear call-to-action]

사용 가능한 프롬프트 템플릿:

• create-product-demo - 전문적인 제품 데모

• create-social-content - TikTok/Instagram/YouTube 콘텐츠

• create-educational-video - 튜토리얼 및 교육 콘텐츠

• create-marketing-campaign - 마케팅 및 홍보 영상

• analyze-video-performance - 비디오 최적화 및 분석

📊 실시간 로깅 및 진행 상황

서버는 여러 심각도 수준을 갖춘 구조화된 로깅을 제공합니다.

[INFO] Creatify MCP Server initialized
[INFO] Creating avatar video {avatarId: "anna_costume1_cameraA", aspectRatio: "16:9"}
[INFO] Waiting for avatar video completion...
[INFO] Avatar video completed {videoId: "video_abc123"}

로그 수준: debug , info , notice , warning , error , critical , alert , emergency

🤖 AI 셀프헬프 시스템

AI 보조원은 이제 how_to_use 도구를 사용하여 도구 매개변수를 더 잘 이해할 수 있습니다.

Claude: Let me check how to use the avatar video tool...

[Calls how_to_use tool with toolName: "create_avatar_video"]

[Gets comprehensive documentation with:
- Required parameters with descriptions
- Optional parameters with usage notes
- Real code examples
- Tips and best practices]

Now I understand exactly how to create your avatar video!

사용자 정의 MCP 클라이언트 사용

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "creatify-mcp",
  env: {
    CREATIFY_API_ID: "your-api-id",
    CREATIFY_API_KEY: "your-api-key"
  }
});

const client = new Client({
  name: "my-client",
  version: "1.0.0"
});

await client.connect(transport);

// List available tools
const tools = await client.listTools();
console.log("Available tools:", tools.tools.map(t => t.name));

// Create an avatar video
const result = await client.callTool({
  name: "create_avatar_video",
  arguments: {
    text: "Hello, world! This is an AI-generated video.",
    avatarId: "anna_costume1_cameraA",
    aspectRatio: "16:9",
    waitForCompletion: true
  }
});

독립형 서버

# Set environment variables
export CREATIFY_API_ID="your-api-id"
export CREATIFY_API_KEY="your-api-key"

# Run the server
creatify-mcp

AI 어시스턴트를 위한 예시 프롬프트

Claude Desktop이나 다른 MCP 클라이언트로 구성하면 다음과 같은 자연어 프롬프트를 사용할 수 있습니다.

• "Anna가 '제품 데모에 오신 것을 환영합니다'라고 말하는 16:9 아바타 비디오를 만들고 완료될 때까지 기다리세요."

• "웹사이트 https://example.com을 홍보 영상으로 변환하세요"

• "전문가의 음성을 사용하여 'Hello world'에 대한 텍스트 음성 변환 오디오를 생성합니다."

• "사용 가능한 모든 아바타와 세부 정보를 보여주세요"

• "내 남은 Createify 크레딧을 확인하세요"

• "새로운 제품에 대해 논의하는 두 아바타 간의 대화를 만들어 보세요"

API 참조

도구

create_avatar_video

입술 동기화된 음성으로 AI 아바타 비디오를 만들어 보세요.

매개변수:

• text (문자열, 필수) - 말할 텍스트

• avatarId (문자열, 필수) - 사용할 아바타 ID

• aspectRatio ("16:9" | "9:16" | "1:1", 필수) - 비디오 종횡비

• voiceId (문자열, 선택 사항) - 아바타의 음성 ID

• waitForCompletion (부울, 선택 사항) - 비디오 완료 대기

create_url_to_video

웹사이트 URL을 전문적인 비디오로 변환합니다.

매개변수:

• url (문자열, 필수) - 변환할 URL

• visualStyle (문자열, 선택 사항) - 시각적 스타일 템플릿

• scriptStyle (문자열, 선택 사항) - 스크립트 작성 스타일

• aspectRatio ("16:9" | "9:16" | "1:1", 선택 사항) - 비디오 종횡비

• waitForCompletion (부울, 선택 사항) - 비디오 완료 대기

generate_text_to_speech

텍스트에서 자연스러운 음성을 생성합니다.

매개변수:

• text (문자열, 필수) - 음성으로 변환할 텍스트

• voiceId (문자열, 필수) - 사용할 음성 ID

• waitForCompletion (boolean, 선택 사항) - 오디오 완료 대기

get_video_status

비디오 생성 작업의 상태를 확인합니다.

매개변수:

• videoId (문자열, 필수) - 확인할 비디오/작업 ID

• videoType (문자열, 필수) - 작업 유형("립싱크", "url-to-video" 등)

자원

creatify://avatars

ID, 이름, 메타데이터와 함께 사용 가능한 모든 AI 아바타의 JSON 목록을 반환합니다.

creatify://voices

텍스트 음성 생성에 사용할 수 있는 모든 음성의 JSON 목록을 반환합니다.

creatify://templates

사용 가능한 사용자 정의 비디오 템플릿의 JSON 목록을 반환합니다.

creatify://credits

현재 계좌의 신용 잔액과 사용 정보를 반환합니다.

개발

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode with auto-reload
npm run dev

# Run tests
npm test

# Lint and format code
npm run check

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 커밋하세요( git commit -m 'Add amazing feature' )

4. 브랜치에 푸시( git push origin feature/amazing-feature )

5. 풀 리퀘스트 열기

특허

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

관련 프로젝트

• @tsavo/creatify-api-ts - Creatify API용 TypeScript 클라이언트

• 모델 컨텍스트 프로토콜 - 프로토콜 사양

• Creatify AI - AI 비디오 생성 플랫폼

📚 포괄적인 문서

🎬 비디오 튜토리얼

곧 출시 - 실제 사용 시나리오를 보여주는 포괄적인 비디오 튜토리얼

📖 API 참조

자세한 API 문서는 다음을 참조하세요.

• Creatify API 문서 - 공식 Creatify API 문서

• @tsavo/creatify-api-ts 문서 - TypeScript 클라이언트 라이브러리 문서

• 모델 컨텍스트 프로토콜 사양 - MCP 프로토콜 세부 정보

🔧 고급 구성

환경 변수

Claude Desktop 고급 구성

{
  "mcpServers": {
    "creatify": {
      "command": "creatify-mcp",
      "env": {
        "CREATIFY_API_ID": "your-api-id",
        "CREATIFY_API_KEY": "your-api-key",
        "MCP_LOG_LEVEL": "info"
      },
      "args": ["--verbose"]
    }
  }
}

🚀 성능 최적화

배치 작업

여러 개의 비디오를 제작하는 경우 일괄 처리 기능을 사용하는 것을 고려해 보세요.

// Example: Create multiple videos efficiently
const videos = await Promise.all([
  client.callTool({
    name: "create_avatar_video",
    arguments: { text: "Video 1", avatarId: "anna", aspectRatio: "16:9" }
  }),
  client.callTool({
    name: "create_avatar_video",
    arguments: { text: "Video 2", avatarId: "john", aspectRatio: "16:9" }
  })
]);

캐싱 전략

• 아바타/음성 목록 : 1시간 동안 캐시(거의 변경되지 않음)

• 비디오 상태 : 활성 작업에 대해 5~10초마다 폴링

• 템플릿 : 24시간 동안 캐시

🔐 보안 모범 사례

1. API 키를 버전 제어에 커밋하지 마십시오.

2. 모든 민감한 데이터에 환경 변수를 사용하세요

3. API 키를 정기적으로 회전하세요

4. 무단 액세스를 감지하기 위해 API 사용을 모니터링합니다.

5. 모든 웹훅 URL에 HTTPS를 사용하세요

🐛 문제 해결

일반적인 문제

"API 자격 증명을 찾을 수 없습니다"

# Solution: Set environment variables
export CREATIFY_API_ID="your-api-id"
export CREATIFY_API_KEY="your-api-key"

"비디오 생성에 실패했습니다."

• Creatify 계정 크레딧을 확인하세요

• 아바타/음성 ID가 있는지 확인하세요

• 텍스트가 비어 있지 않은지 확인하세요

• 종횡비가 유효한지 확인하세요

"MCP 연결에 실패했습니다."

• 서버가 실행 중인지 확인하세요

• Claude Desktop 구성 확인

• Node.js 버전 >= 18을 확인하세요.

디버그 모드

# Run with debug logging
MCP_LOG_LEVEL=debug creatify-mcp

📊 모니터링 및 분석

사용 추적

Createfy API 사용량을 모니터링하세요.

// Check remaining credits
const credits = await client.readResource({ uri: "creatify://credits" });
console.log(`Remaining credits: ${JSON.parse(credits.contents[0].text).remaining_credits}`);

성과 지표

• 영상 제작 시간 : 일반적으로 2~5분

• API 응답 시간 : 일반적으로 < 2초

• 성공률 : 실패한 요청 모니터링

🤝 기여하기

여러분의 참여를 환영합니다! 시작하는 방법은 다음과 같습니다.

🛠️ 개발 설정

# Clone the repository
git clone https://github.com/TSavo/creatify-mcp.git
cd creatify-mcp

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your API credentials

# Run tests
npm test

# Build the project
npm run build

# Run in development mode
npm run dev

🧪 테스트

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run type checking
npm run type-check

# Run linting
npm run lint

📝 코드 스타일

우리는 다음을 사용합니다:

• 코드 린팅을 위한 ESLint

• 코드 포맷팅에 더 좋음

• 유형 안전을 위한 TypeScript

• 커밋 메시지에 대한 기존 커밋

🔄 풀 리퀘스트 프로세스

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 만드세요

4. 새로운 기능에 대한 테스트 추가

5. 모든 테스트가 통과되었는지 확인하세요( npm test )

6. 린팅 실행( npm run lint:fix )

7. 변경 사항을 커밋합니다( git commit -m 'feat: add amazing feature' )

8. 브랜치에 푸시( git push origin feature/amazing-feature )

9. 풀 리퀘스트 열기

📄 라이센스

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

🙏 감사의 말

• Creatify AI - 놀라운 AI 비디오 생성 플랫폼 제공

• @tsavo/creatify-api-ts - 이 서버를 구동하는 강력한 TypeScript 클라이언트 라이브러리

• Anthropic - Claude와 모델 컨텍스트 프로토콜을 위해

• MCP 커뮤니티 - 이 통합을 가능하게 하는 표준화된 프로토콜을 위해

📞 지원

• 📖 Creatify API 문서 - 공식 API 문서

• 🐛 문제 보고 - 버그 보고 및 기능 요청

• 💬 MCP 커뮤니티 - 커뮤니티 토론

• 📧 저자에게 문의하기 - 직접 지원

T Savo 가 ❤️로 만들었습니다

🌐 호라이즌 시티 - AI 혁명을 선도하고 인류 멸종을 앞당기다

모든 개발자와 AI 지원자가 AI 비디오 생성에 접근할 수 있도록 하여 인간의 쓸모없음에 한 걸음 더 다가가다