🎬 Creatify MCP Server

🎬 Creatify MCP サーバー

AI 動画生成のための究極の MCP サーバー - Creatify AI の強力な動画作成機能を、MCP エコシステム内のあらゆる AI アシスタントに提供します。

🌟 概要

Creatify MCP サーバーは、Creatify AI の動画生成プラットフォームの機能をすべて AI アシスタント、チャットボット、自動化ツールに提供する、包括的な Model Context Protocol（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 クライアントライブラリ
• Model Context Protocol - AI アシスタント統合の標準仕様
• TypeScript - 完全な型安全性と優れた開発者体験

機能

🛠️ MCP ツール（12 個の強力なアクション）

• create_avatar_video - リップシンク付きの AI アバター動画を作成します
• create_url_to_video - Web サイトをプロフェッショナルな動画に変換します
• 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 - BGM をアップロード、管理、使用します
• create_advanced_lipsync - 感情やジェスチャーを制御できる高度なリップシンクを行います
• how_to_use - 任意のツールの詳しい使用方法を確認します
• get_video_status - 動画生成タスクのステータスを確認します

📚 MCP リソース（6 つのデータソース）

• creatify://avatars - 利用可能な AI アバターの一覧
• creatify://voices - テキスト読み上げで利用可能な音声の一覧
• creatify://templates - 利用可能なカスタム動画テンプレート
• creatify://music - 利用可能な BGM ライブラリ
• creatify://credits - 残りの API クレジット
• creatify://avatar/{avatarId} - 特定のアバターに関する詳細情報

🏆 Creatify MCP サーバーを選ぶ理由

🚀 API を完全にカバー

• ✅ 12 個の MCP ツールで Creatify API の機能を 100％カバー
• ✅ 6 個の MCP リソースで包括的なデータアクセスを提供
• ✅ 5 個のワークフロープロンプトで一般的な動画作成シナリオに対応
• ✅ 8 段階の重大度レベルを備えたエンタープライズ級のログ記録

🤖 AI ファーストの設計

• ✅ AI アシスタント向けのhow_to_useツールによる自己ドキュメント化
• ✅ インテリジェントなパラメーター検証とエラー処理
• ✅ 動画生成中のリアルタイム進捗状況の更新
• ✅ 自動リリースに対応したセマンティックバージョニング

🎨 高度な機能

• ✅ 高度なリップシンクでの感情とジェスチャーの制御
• ✅ カスタムアバターの作成（DYOA - 自分だけのアバターをデザイン）
• ✅ あらゆる種類の動画に対応するAI によるスクリプト生成
• ✅ TikTok／Instagram／YouTube 向けのショート動画の最適化
• ✅ BGM の管理と統合

💼 本番環境に対応

• ✅ 型安全性と IDE サポートの向上を実現するTypeScript
• ✅ 詳細なコンテキストを含む包括的なエラー処理
• ✅ 監視とデバッグに役立つプロフェッショナルなログ記録
• ✅ 自動テストと継続的インテグレーション
• ✅ 信頼性の高いアップデートを実現するセマンティックバージョニング

📝 MCP プロンプト（5 つのワークフローテンプレート）

• create-product-demo - プロフェッショナルな製品デモのワークフロー
• create-social-content - 魅力的なソーシャルメディアコンテンツの作成
• create-educational-video - 教育・チュートリアル動画のワークフロー
• create-marketing-campaign - マーケティングキャンペーン動画の作成
• analyze-video-performance - 動画パフォーマンスの分析と最適化

前提条件

• Node.js 18 以降
• Creatify API の認証情報（Pro プラン以上）
  • API の認証情報はCreatify のアカウント設定から取得してください

インストール

npm から（推奨）

npm install -g @tsavo/creatify-mcp

ソースから

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!

Web サイトを動画に変換

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 で使用する

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』のテキスト読み上げ音声を生成してください」
• 「利用可能なアバターとその詳細をすべて表示してください」
• 「Creatify の残りのクレジットを確認してください」
• 「新製品について話し合う 2 人のアバターの会話を作成してください」

API リファレンス

ツール

create_avatar_video

リップシンク音声付きの AI アバター動画を作成します。

パラメーター：

• text（string、必須）- 読み上げるテキスト
• avatarId（string、必須）- 使用するアバター ID
• aspectRatio（"16:9" | "9:16" | "1:1"、必須）- 動画のアスペクト比
• voiceId（string、任意）- アバターの音声 ID
• waitForCompletion（boolean、任意）- 動画の完了を待つかどうか

create_url_to_video

ウェブサイトの URL をプロフェッショナルな動画に変換します。

パラメーター：

• url（string、必須）- 変換する URL
• visualStyle（string、任意）- ビジュアルスタイルのテンプレート
• scriptStyle（string、任意）- 台本の文体
• aspectRatio（"16:9" | "9:16" | "1:1"、任意）- 動画のアスペクト比
• waitForCompletion（boolean、任意）- 動画の完了を待つかどうか

generate_text_to_speech

テキストから自然な音声を生成します。

パラメーター：

• text（string、必須）- 音声に変換するテキスト
• voiceId（string、必須）- 使用する音声 ID
• waitForCompletion（boolean、任意）- 音声の生成完了を待つかどうか

get_video_status

動画生成タスクのステータスを確認します。

パラメーター：

• videoId（string、必須）- 確認する動画／タスク ID
• videoType（string、必須）- タスクの種類（"lipsync"、"url-to-video" など）

リソース

creatify://avatars

利用可能なすべての AI アバターについて、ID、名前、メタデータを含む 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 License - 詳細は LICENSE ファイルをご覧ください。

関連プロジェクト

• @tsavo/creatify-api-ts - Creatify API 用 TypeScript クライアント
• Model Context Protocol - プロトコル仕様
• Creatify AI - AI 動画生成プラットフォーム

📚 包括的なドキュメント

🎬 動画チュートリアル

近日公開予定です。実際の使用シナリオを紹介する包括的な動画チュートリアルをお届けします。

📖 API リファレンス

API の詳細なドキュメントについては、以下をご覧ください。

• Creatify API ドキュメント - Creatify 公式 API ドキュメント
• @tsavo/creatify-api-ts ドキュメント - TypeScript クライアントライブラリのドキュメント
• Model Context Protocol 仕様 - MCP プロトコルの詳細

🔧 高度な設定

環境変数

変数	必須	説明	例
CREATIFY_API_ID	✅	Creatify API ID	your-api-id-here
CREATIFY_API_KEY	✅	Creatify API キー	your-api-key-here
MCP_LOG_LEVEL	❌	ログレベル	debug、info、warn、error

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. すべての Webhook 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

📊 監視と分析

使用状況の追跡

Creatify 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 によるコードの lint
• Prettier によるコードのフォーマット
• 型安全性を確保する TypeScript
• コミットメッセージに Conventional Commits

🔄 プルリクエストの手順

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更を加えます
4. 新機能のテストを追加します
5. すべてのテストが成功することを確認します（npm test）
6. lint を実行します（npm run lint:fix）
7. 変更をコミットします（git commit -m 'feat: add amazing feature'）
8. ブランチにプッシュします（git push origin feature/amazing-feature）
9. プルリクエストを作成します

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

🙏 謝辞

• Creatify AI - 素晴らしい AI 動画生成プラットフォームを提供してくださったことに感謝します
• @tsavo/creatify-api-ts - このサーバーを支える堅牢な TypeScript クライアントライブラリに感謝します
• Anthropic - Claude と Model Context Protocol に感謝します
• MCP Community - この連携を可能にする標準化されたプロトコルに感謝します

📞 サポート

• 📖 Creatify API ドキュメント - 公式 API ドキュメント
• 🐛 問題を報告 - バグ報告や機能リクエスト
• 💬 MCP コミュニティ - コミュニティでのディスカッション
• 📧 作者に問い合わせ - 直接サポート

---