🎬 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: 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- 利用可能な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-mcpAIアシスタントのプロンプト例
Claude Desktop または別の MCP クライアントで設定すると、次のような自然言語プロンプトを使用できるようになります。
「『製品デモへようこそ』とアナが言う16:9のアバター動画を作成し、完了するまで待ちます」
「ウェブサイトhttps://example.comをプロモーションビデオに変換する」
「プロの声を使って『Hello world』のテキスト読み上げ音声を生成する」
「利用可能なすべてのアバターとその詳細を表示」
「残りのCreatefyクレジットを確認してください」
「新製品について話し合う2人のアバター間の会話を作成してください」
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(ブール値、オプション) - オーディオの完了を待つ
get_video_status
ビデオ生成タスクのステータスを確認します。
パラメータ:
videoId(文字列、必須) - チェックするビデオ/タスクIDvideoType(文字列、必須) - タスクの種類 (「リップシンク」、「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貢献
リポジトリをフォークする
機能ブランチを作成する (
git checkout -b feature/amazing-feature)変更をコミットします(
git commit -m 'Add amazing feature')ブランチにプッシュする (
git push origin feature/amazing-feature)プルリクエストを開く
ライセンス
MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。
関連プロジェクト
@tsavo/creatify-api-ts- Creatify API 用の TypeScript クライアントモデルコンテキストプロトコル- プロトコル仕様
Creatify AI - AIビデオ生成プラットフォーム
📚 包括的なドキュメント
🎬 ビデオチュートリアル
近日公開予定 - 実際の使用シナリオを示す包括的なビデオチュートリアル
📖 APIリファレンス
詳細な API ドキュメントについては、以下を参照してください。
Creatify APIドキュメント- 公式Creatify APIドキュメント
@tsavo/creatify-api-ts ドキュメント- TypeScript クライアント ライブラリのドキュメント
モデルコンテキストプロトコル仕様- MCPプロトコルの詳細
🔧 詳細設定
環境変数
変数 | 必須 | 説明 | 例 |
| ✅ | Createify API ID |
|
| ✅ | Createify APIキー |
|
| ❌ | ログレベル |
|
クロードデスクトップの詳細設定
{
"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時間キャッシュ
🔐 セキュリティのベストプラクティス
APIキーをバージョン管理にコミットしない
すべての機密データに環境変数を使用する
APIキーを定期的にローテーションする
APIの使用状況を監視して不正アクセスを検出する
すべての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
🔄 プルリクエストのプロセス
リポジトリをフォークする
機能ブランチを作成する (
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 ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
🙏 謝辞
Creatify AI - 素晴らしいAIビデオ生成プラットフォームを提供してくれた
@tsavo/creatify-api-ts - このサーバーを動かす堅牢なTypeScriptクライアントライブラリ
人類学的- クロードとモデルコンテキストプロトコルのために
MCPコミュニティ- この統合を可能にする標準化されたプロトコル
📞 サポート
📖 Creatify API ドキュメント- 公式 API ドキュメント
🐛**問題の報告**- バグ報告と機能リクエスト
💬 MCP コミュニティ- コミュニティディスカッション
📧**著者への連絡**- 直接サポート
T Savoが ❤️ で作成
🌐**ホライゾンシティ**- AI革命の到来と人類の絶滅の加速
AIビデオ生成をすべての開発者とAIアシスタントが利用できるようにすることで、人類の陳腐化に一歩近づく
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.