🎬 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に*「『製品デモへようこそ』とアナが言う16:9のアバター動画を作成して、完了するまで待ってください」と指示し*、実際に動画が完成するところを想像してみてください。これがこのMCPサーバーの力です。

🏗️ で構築

• Creatify AI API - 世界をリードするAIビデオ生成プラットフォーム

• @tsavo/creatify-api-ts - 包括的な TypeScript クライアント ライブラリ

• モデルコンテキストプロトコル- 標準化されたAIアシスタント統合

• TypeScript - 完全な型安全性と優れた開発者エクスペリエンス

Related MCP server: Grok Imagine Video MCP Server

特徴

🛠️ 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 - 利用可能なBGMライブラリ

• 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以上

• Createfy API 認証情報 (Pro プラン以上)

  • Createfyのアカウント設定からAPI認証情報を取得する

インストール

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!

ウェブサイトをビデオに変換する

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.

構成

Createfy 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 クライアントで設定すると、次のような自然言語プロンプトを使用できるようになります。

• 「『製品デモへようこそ』とアナが言う16:9のアバター動画を作成し、完了するまで待ちます」

• 「ウェブサイトhttps://example.comをプロモーションビデオに変換する」

• 「プロの声を使って『Hello world』のテキスト読み上げ音声を生成する」

• 「利用可能なすべてのアバターとその詳細を表示」

• 「残りのCreatefyクレジットを確認してください」

• 「新製品について話し合う2人のアバター間の会話を作成してください」

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 (ブール値、オプション) - オーディオの完了を待つ

get_video_status

ビデオ生成タスクのステータスを確認します。

パラメータ:

• videoId (文字列、必須) - チェックするビデオ/タスクID

• videoType (文字列、必須) - タスクの種類 (「リップシンク」、「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ファイルを参照してください。

関連プロジェクト

• @tsavo/creatify-api-ts - Creatify API 用の TypeScript クライアント

• モデルコンテキストプロトコル- プロトコル仕様

• Creatify AI - AIビデオ生成プラットフォーム

📚 包括的なドキュメント

🎬 ビデオチュートリアル

近日公開予定 - 実際の使用シナリオを示す包括的なビデオチュートリアル

📖 APIリファレンス

詳細な API ドキュメントについては、以下を参照してください。

• Creatify APIドキュメント- 公式Creatify APIドキュメント

• @tsavo/creatify-api-ts ドキュメント- TypeScript クライアント ライブラリのドキュメント

• モデルコンテキストプロトコル仕様- MCPプロトコルの詳細

🔧 詳細設定

環境変数

クロードデスクトップの詳細設定

{
  "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"

「ビデオの作成に失敗しました」

• Createfyアカウントのクレジットを確認する

• アバター/音声IDが存在することを確認する

• テキストが空でないことを確認する

• アスペクト比が有効かどうかを確認してください

「MCP接続に失敗しました」

• サーバーが実行中であることを確認する

• Claude Desktopの設定を確認する

• Node.js バージョン >= 18 であることを確認する

デバッグモード

# Run with debug logging
MCP_LOG_LEVEL=debug creatify-mcp

📊 監視と分析

使用状況の追跡

Createify 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

• コードフォーマット用のPrettier

• 型安全性のためのTypeScript

• コミットメッセージのConventional Commits

🔄 プルリクエストのプロセス

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 ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• Creatify AI - 素晴らしいAIビデオ生成プラットフォームを提供してくれた

• @tsavo/creatify-api-ts - このサーバーを動かす堅牢なTypeScriptクライアントライブラリ

• 人類学的- クロードとモデルコンテキストプロトコルのために

• MCPコミュニティ- この統合を可能にする標準化されたプロトコル

📞 サポート

• 📖 Creatify API ドキュメント- 公式 API ドキュメント

• 🐛**問題の報告**- バグ報告と機能リクエスト

• 💬 MCP コミュニティ- コミュニティディスカッション

• 📧**著者への連絡**- 直接サポート

T Savoが ❤️ で作成

🌐**ホライゾンシティ**- AI革命の到来と人類の絶滅の加速

AIビデオ生成をすべての開発者とAIアシスタントが利用できるようにすることで、人類の陳腐化に一歩近づく