Skip to main content
Glama

🎬 MCPサーバーを作成する

npmバージョン npmダウンロード CI タイプスクリプト Node.js MCP クリエイティファイAI ライセンス: MIT GitHubスター GitHubの問題 セマンティックリリース

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サーバーの力です。

🏗️ で構築

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 - ビデオパフォーマンスの分析と最適化

前提条件

インストール

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ファイルを参照してください。

関連プロジェクト

📚 包括的なドキュメント

🎬 ビデオチュートリアル

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

📖 APIリファレンス

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

🔧 詳細設定

環境変数

変数

必須

説明

例

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

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

{
  "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コミュニティ- この統合を可能にする標準化されたプロトコル

📞 サポート


T Savoが ❤️ で作成

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

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

Related MCP Connectors

Related MCP Servers