Luma MCP Server

Luma AIのビデオ生成APIをModel Context Protocol (MCP)として提供するサーバー

🌟 概要

Luma MCP Serverは、Luma AIのビデオ生成機能をMCPサーバーとして提供します。テキストや画像からビデオを生成したり、既存のビデオを拡張・補間したりする機能を提供します。

Related MCP server: MCP Base

🏗️ プロジェクト構造

📦 インストール

⚙️ 環境設定

1. Luma APIキーの取得

   • Luma AI Developer PortalからAPIキーを取得してください。

2. 環境変数の設定

   export LUMA_API_KEY=your_api_key_here

🛠️ 使用可能なツール

generate_video

テキストプロンプトからビデオを生成します。

generate_video_from_image

画像を開始フレームとしてビデオを生成します。

extend_video

既存のビデオを拡張します。

interpolate_videos

2つのビデオ間をスムーズに補間します。

🔧 開発者向け情報

アーキテクチャ

• 型定義 (:

  • schemas.ts: Zodを使用した入力バリデーションスキーマ

  • types.ts: 共通の型定義とインターフェース

• ハンドラー (:

  • tool-handlers.ts: MCPツールのリクエスト処理

• クライアント (:

  • luma-client.ts: Luma AI APIとの通信を担当

• ユーティリティ (:

  • error-handler.ts: 統一的なエラー処理

• 設定 (:

  • server-config.ts: サーバー設定の一元管理

エラーハンドリング

• 統一的なエラー処理システム

• MCPエラーコードへの適切なマッピング

• 詳細なエラーメッセージとロギング

📝 注意事項

• プロンプトは英語で記述してください

• ビデオ生成には時間がかかる場合があります

• APIの利用制限に注意してください

🤝 コントリビューション

1. このリポジトリをフォーク

2. 新しいブランチを作成 (git checkout -b feature/amazing-feature)

3. 変更をコミット (git commit -m '✨ feat: Add amazing feature')

4. ブランチをプッシュ (git push origin feature/amazing-feature)

5. プルリクエストを作成

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください。