🎬 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 - 完全な型安全性と優れた開発者エクスペリエンス
特徴
🛠️ 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から(推奨)
出典
🎬ライブデモの例
AIアバター動画を作成する
TikTokスタイルのショートビデオを生成
ウェブサイトをビデオに変換する
AIによるスクリプト生成
構成
Createfy 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 クライアントで設定すると、次のような自然言語プロンプトを使用できるようになります。
- 「『製品デモへようこそ』とアナが言う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
現在のアカウントのクレジット残高と使用状況情報を返します。
発達
貢献
- リポジトリをフォークする
- 機能ブランチを作成する (
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プロトコルの詳細
🔧 詳細設定
環境変数
変数 | 必須 | 説明 | 例 |
---|---|---|---|
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 |
クロードデスクトップの詳細設定
🚀 パフォーマンスの最適化
バッチ操作
複数のビデオを作成する場合は、バッチ処理機能の使用を検討してください。
キャッシュ戦略
- アバター/ボイスリスト: 1時間キャッシュされます(ほとんど変更されません)
- ビデオステータス: アクティブなタスクを5~10秒ごとにポーリングします
- テンプレート: 24時間キャッシュ
🔐 セキュリティのベストプラクティス
- APIキーをバージョン管理にコミットしない
- すべての機密データに環境変数を使用する
- APIキーを定期的にローテーションする
- APIの使用状況を監視して不正アクセスを検出する
- すべてのWebhook URLにHTTPSを使用する
🐛 トラブルシューティング
よくある問題
「API認証情報が見つかりません」
「ビデオの作成に失敗しました」
- Createfyアカウントのクレジットを確認する
- アバター/音声IDが存在することを確認する
- テキストが空でないことを確認する
- アスペクト比が有効かどうかを確認してください
「MCP接続に失敗しました」
- サーバーが実行中であることを確認する
- Claude Desktopの設定を確認する
- Node.js バージョン >= 18 であることを確認する
デバッグモード
📊 監視と分析
使用状況の追跡
Createify API の使用状況を監視します。
パフォーマンスメトリック
- ビデオ作成時間:通常2~5分
- API応答時間: 通常2秒未満
- 成功率: 失敗したリクエストを監視する
🤝 貢献する
貢献を歓迎します!始めるには、以下の手順に従ってください。
🛠️ 開発セットアップ
🧪 テスト
📝 コードスタイル
使用するのは:
- コードリンティングのための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アシスタントが利用できるようにすることで、人類の陳腐化に一歩近づく
Related MCP Servers
- PythonApache 2.0
- JavaScript
- PythonMIT License
- TypeScript