Novareel MCP

🚀 Amazon Nova Reel 1.1 MCP Server

このサーバーは、AWS Bedrockを使用したAmazon Nova Reel 1.1のビデオ生成用のModel Context Protocol (MCP) サーバーです。非同期のビデオ生成ツールを提供し、包括的なプロンプトガイドラインと、stdioおよびSSEトランスポートのサポートを備えています。

✨ 主な機能

• 非同期ビデオ生成：ビデオ生成ジョブの開始、監視、取得が可能です。
• 複数のトランスポート方法：stdio、Server-Sent Events (SSE)、HTTP Streamingをサポートしています。
• 包括的なプロンプトガイド：AWSのドキュメントに基づくガイドラインが組み込まれています。
• Dockerサポート：すべてのトランスポート方法に対応したDockerコンテナが用意されています。
• AWS統合：AWS BedrockとS3との完全な統合が可能です。

📦 インストール

前提条件

• Python 3.8以上
• Bedrockアクセス権を持つAWSアカウント
• ビデオ出力用のS3バケット
• 適切な権限を持つAWS認証情報

ローカルインストール

1. サーバーファイルをクローンまたはダウンロードします。
2. 依存関係をインストールします。

pip install -e .

Dockerインストール

事前構築済みイメージの使用 (推奨)

GitHub Container Registryからマルチアーキテクチャのイメージを取得します。

# STDIOバージョン
docker pull ghcr.io/mirecekd/novareel-mcp:latest-stdio

# SSEバージョン  
docker pull ghcr.io/mirecekd/novareel-mcp:latest-sse

# HTTP Streamingバージョン
docker pull ghcr.io/mirecekd/novareel-mcp:latest-http

ローカルでのビルド

1. 提供されているスクリプトを使用してコンテナをビルドします。

# すべてのバージョンをビルド
./build-all.sh

# 個別のバージョンをビルド
./build-stdio.sh    # STDIOバージョン
./build-sse.sh      # SSEバージョン
./build-http.sh     # HTTP Streamingバージョン

2. またはdocker-composeを使用します。

docker-compose up -d

3. またはクイックスタートスクリプトを使用します。

# すべてのイメージをビルド
./start.sh build

# 特定のバージョンをビルド
./start.sh build-stdio
./start.sh build-sse
./start.sh build-http

🔧 設定

環境変数

• AWS_ACCESS_KEY_ID：あなたのAWSアクセスキーID
• AWS_SECRET_ACCESS_KEY：あなたのAWSシークレットアクセスキー
• AWS_REGION：AWSリージョン (デフォルト: us-east-1)
• S3_BUCKET：ビデオ出力用のS3バケット名

.envファイルの例

docker-compose用の.envファイルを作成します。

AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
AWS_REGION=us-east-1
S3_BUCKET=my-video-generation-bucket

💻 使用例

MCPクライアントの統合 (Cline/Claude Desktop)

サーバーをMCPクライアントの設定に追加します。

Clineの設定

ClineのMCP設定に追加します。

{
  "mcpServers": {
    "Nova Reel Video MCP": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mirecekd/novareel-mcp:latest-stdio",
        "--aws-access-key-id",
        "YOUR_AWS_ACCESS_KEY_ID",
        "--aws-secret-access-key",
        "YOUR_AWS_SECRET_ACCESS_KEY",
        "--s3-bucket",
        "YOUR_S3_BUCKET_NAME"
      ]
    }
  }
}

Claude Desktopの設定

Claude Desktopのclaude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "novareel-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i", 
        "--rm",
        "ghcr.io/mirecekd/novareel-mcp:latest-stdio",
        "--aws-access-key-id",
        "YOUR_AWS_ACCESS_KEY_ID",
        "--aws-secret-access-key",
        "YOUR_AWS_SECRET_ACCESS_KEY",
        "--s3-bucket",
        "YOUR_S3_BUCKET_NAME"
      ]
    }
  }
}

代替案: ローカルPythonインストール

Dockerを使用せずに実行する場合は、次のように設定します。

{
  "mcpServers": {
    "novareel-mcp": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/mirecekd/novareel-mcp.git",
        "novareel-mcp-server",
        "--aws-access-key-id", "YOUR_AWS_ACCESS_KEY_ID",
        "--aws-secret-access-key", "YOUR_AWS_SECRET_ACCESS_KEY",
        "--s3-bucket", "YOUR_S3_BUCKET_NAME"
      ]
    }
  }
}

重要: プレースホルダーの値を実際のAWS認証情報とS3バケット名に置き換えてください。

uvxでの実行 (推奨)

# まずパッケージをビルド
./build.sh

# 次にホイールファイルから実行
uvx --from ./dist/novareel_mcp-1.0.0-py3-none-any.whl novareel-mcp-server --aws-access-key-id YOUR_KEY --aws-secret-access-key YOUR_SECRET --s3-bucket YOUR_BUCKET

# または開発中はビルドせずに現在のディレクトリから実行
uvx --from . novareel-mcp-server --aws-access-key-id YOUR_KEY --aws-secret-access-key YOUR_SECRET --s3-bucket YOUR_BUCKET

# またはstartスクリプトを使用
./start.sh build-package  # ホイールをビルド

STDIOバージョン (直接MCPクライアント)

# ローカル実行
python main.py --aws-access-key-id YOUR_KEY --aws-secret-access-key YOUR_SECRET --s3-bucket YOUR_BUCKET

# Docker実行
docker run --rm -i mirecekd/novareel-mcp-server:stdio --aws-access-key-id YOUR_KEY --aws-secret-access-key YOUR_SECRET --s3-bucket YOUR_BUCKET

SSEバージョン (Webインターフェース)

# ローカル実行
python -m novareel_mcp_server.server_sse --aws-access-key-id YOUR_KEY --aws-secret-access-key YOUR_SECRET --s3-bucket YOUR_BUCKET --host 0.0.0.0 --port 8000

# Docker実行
docker run -p 8000:8000 -e AWS_ACCESS_KEY_ID=YOUR_KEY -e AWS_SECRET_ACCESS_KEY=YOUR_SECRET -e S3_BUCKET=YOUR_BUCKET mirecekd/novareel-mcp-server:sse

その後、http://localhost:8000/sse/にアクセスしてSSEエンドポイントを使用します。

HTTP Streamingバージョン (双方向トランスポート)

# ローカル実行
python -m novareel_mcp_server.server_http --aws-access-key-id YOUR_KEY --aws-secret-access-key YOUR_SECRET --s3-bucket YOUR_BUCKET --host 0.0.0.0 --port 8001

# Docker実行
docker run -p 8001:8001 -e AWS_ACCESS_KEY_ID=YOUR_KEY -e AWS_SECRET_ACCESS_KEY=YOUR_SECRET -e S3_BUCKET=YOUR_BUCKET ghcr.io/mirecekd/novareel-mcp:latest-http

その後、http://localhost:8001にアクセスしてHTTPストリーミングトランスポートを使用します。

パッケージビルド

配布用のパッケージを作成するには、次のコマンドを実行します。

# ビルドツールをインストール
pip install build

# パッケージを作成
python3 -m build

# 出力ファイルはdist/に保存されます

基本的なビデオ生成

# ビデオ生成ジョブを開始
result = start_async_invoke(
    prompt="A majestic eagle soars over a mountain valley, camera tracking its flight as it circles above a pristine lake",
    duration_seconds=24,
    fps=24,
    dimension="1920x1080"
)

job_id = result["job_id"]
print(f"Started job: {job_id}")

# ジョブのステータスを確認
status = get_async_invoke(job_id)
print(f"Status: {status['status']}")

# 完了したら、ビデオURLを取得
if status["status"] == "Completed":
    print(f"Video URL: {status['video_url']}")

すべてのジョブをリストする

# すべてのジョブの概要を取得
jobs = list_async_invokes()
print(f"Total jobs: {jobs['total_invocations']}")
print(f"Completed: {jobs['summary']['completed']}")
print(f"In progress: {jobs['summary']['in_progress']}")

📚 ドキュメント

プロンプトガイドライン

サーバーには、AWSのドキュメントに基づく包括的なプロンプトガイドラインが組み込まれています。次のコードでアクセスできます。

guide = get_prompting_guide()

重要なプロンプトのヒント

1. 具体的に記述する：詳細で描写的な言葉を使用します。

   • 良い例: "A red cardinal perched on a snow-covered pine branch, morning sunlight filtering through the trees"
   • 悪い例: "A bird on a tree"

2. カメラ用語を使用する：ショット構成をコントロールします。

   • "Close-up shot of hands carving wood"
   • "Wide shot establishing the mountain landscape"
   • "Camera pans left across the valley"

3. 照明の詳細を含める：雰囲気を指定します。

   • "Golden hour lighting casting long shadows"
   • "Soft blue hour twilight"
   • "Dramatic storm clouds overhead"

4. ビデオの長さに合わせて構成する：複雑さをビデオの長さに合わせます。

   • 12-24秒: 単一のアクションまたは瞬間
   • 30-60秒: 2-3つの異なるアクション
   • 60-120秒: 複数のシーンを含む完全な物語

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

サポート

問題や質問がある場合は、以下の手順を試してください。

1. トラブルシューティングセクションを確認します。
2. AWS Bedrockのドキュメントを確認します。
3. リポジトリに問題を報告します。

関連リンク

• AWS Nova Reel Documentation
• Video Generation Prompting Guide
• Camera Control Prompting
• Model Context Protocol
• FastMCP Framework