Skip to main content
Glama
nibhasdongre

AI-Multimodal-Campaign-Architect

by nibhasdongre

AI Multimodal Campaign Architect

エージェンティックワークフロー · モデルコンテキストプロトコル

人間によるチェックポイントを高コスト工程の前に挟みながら、マーケティングキャンペーン全体の企画、執筆、イラスト作成、音声生成を実行するエージェンティックMCPワークフローです。

「Z世代向けの大胆なスニーカーブランドを立ち上げる」という1つのプロンプトを与えるだけで、MCPツールのエージェンティックパイプラインがコピー、ムードボード、ナレーション、プレゼンテーションピッチ、最終的なキャンペーン画像を生成します。その過程では自動ガードレールと厳格な予算上限が適用されます。

仕組みを見る : https://ai-multimodal-campaign-architect-gl808c9v7-nibha-dongre.vercel.app/


機能

  1. コピー生成 — Geminiが1つのキャンペーンプロンプトから、見出し、本文コピー、ターゲットオーディエンス、コアメッセージ、詳細なビジュアルコンセプト、約15秒のナレーションスクリプトを生成します。

  2. 並列ファンアウト (asyncio.gather、最も遅い呼び出しに制限され、合計時間にはなりません):

    • Unsplashからムードボードを構築し、画像生成に費用をかける前にビジュアルの方向性を安価に検証します

    • スクリプトからナレーションを合成します (gTTS)

    • プレゼンテーションピッチ — ターゲットオーディエンス、コアメッセージ、CTA、デザインの根拠をドラフトします

    • ガードレールチェック — ルールベースのパス(禁止用語、長さ制限)とLLMベースのパス(検証不可能な主張、トーンの整合性)を実行します

  3. ヒューマン・イン・ザ・ループチェックポイント — 担当者がムードボードを確認し、パイプラインが画像生成に費用を費やす前にビジュアルの方向性を承認(または上書き)します。

  4. 確認されたビジュアルコンセプトを使用して、Pollinations.ai経由で最終画像を生成します。

  5. 制限付き自動批評 — ガードレールチェックに失敗したフィールドは、正確に1回の自動書き換えパスが実行されます。リトライループやコストの暴走はなく、失敗は手動フォローアップのために記録されます。

Related MCP server: PrePilot MCP Server

パイプライン

RECEIVE BRAND REQUIREMENT ──▶ GENERATE COPY ──┬──▶ BUILD MOODBOARD ─────┐
                                               ├──▶ GENERATE AUDIO ──────┤
                                               ├──▶ CREATE PITCH ────────┼──▶ HUMAN IN THE LOOP ──▶ GENERATE IMAGE
                                               └──▶ RUN GUARDRAILS ──────┘
                                               (parallel batch — asyncio.gather)

技術スタック

レイヤー

スタック

MCPサーバー

Python, FastMCP, Pydantic (型付きツールスキーマ)

コピー / ピッチ / ガードレール

Gemini API (gemini-flash-lite-latest)

ムードボード

Unsplash API

画像生成

Pollinations.ai (無料、キー不要)

ナレーション

gTTS

フロントエンド

Next.js (App Router), TypeScript, Tailwind CSS

費用が発生するのはGeminiとUnsplashの呼び出しのみです。どちらも generous な無料枠があり、セッションごとの予算上限により、状況に関わらず厳格な上限が適用されます(コストと予算管理を参照)。

プロジェクト構造

.
├── server.py              # MCP server — exposes each pipeline step as a typed tool
├── client.py               # MCP transport client
├── orchestrator.py         # Pipeline DAG: sequencing, parallel fan-out, budget enforcement
├── run_demo.py              # Runs the 4 showcase campaigns end-to-end, writes campaign_outputs/
├── requirements.txt
├── .env.example
│
├── app/                    # Next.js app router pages
├── components/              # DemoGrid, DemoModal, PipelineDiagram, ByokPanel, etc.
├── data/
│   ├── demos.ts             # Auto-generated by scripts/build-demo-data.mjs — do not hand-edit
│   └── features.ts
├── public/
│   ├── demo.gif
│   └── demos/                # Campaign assets copied in at build time
├── scripts/
│   └── build-demo-data.mjs   # Reads campaign_outputs/, populates data/demos.ts + public/demos/
└── package.json

リポジトリがPythonバックエンドとNext.jsフロントエンドを共有ルートではなく別々のサブフォルダに分割している場合は、このツリーを調整してください。

公開されているMCPツール

ツール

目的

コスト

generate_copy

見出し、本文コピー、ビジュアルコンセプト、ナレーションスクリプト — 他のすべてのツールが依存するコンテキストソース

Gemini (小)

generate_moodboard

参考画像のためのUnsplash検索 — 有料の画像生成前に方向性を検証する安価な方法

無料

generate_image

確認されたビジュアルコンセプトからの最終キャンペーン画像

無料 (Pollinations.ai)

generate_audio_asset

キャンペーンスクリプトからのテキスト読み上げナレーション

無料 (gTTS)

create_presentation_pitch

ターゲットオーディエンス、コアメッセージ、CTA、デザインの根拠

Gemini (小)

refine_content

他のすべてを固定したまま、単一のフィールド(見出し/本文コピー/音声スクリプト)を分離して再生成します

Gemini (小)

run_guardrail_check

ルールベースのスクリーニング: 禁止用語、見出し/スクリプトの長さ制限

無料

run_llm_guardrail_check

モデルベースのスクリーニング: 検証不可能な主張、ブランドコンテキストに対するトーンの整合性

Gemini (小)

retrieve_brand_context

コピー生成の基盤となるブランドボイス/ガイドラインのRAGスタイル取得

無料 (スタブ — 実際の埋め込み検索は計画中の拡張機能です)

コストと予算管理

CampaignOrchestratorは、呼び出しごとの実際の報告されたコストを追跡し、セッションごとの厳格な上限(budget_cap_usd、デフォルト$0.50)を適用します。上限に達すると、それ以降の有料呼び出しは完全に拒否されます。パイプラインはクラッシュせず、単に支出を停止します。無料ツール(ムードボード、音声、ルールベースのガードレール)は上限によってブロックされることはありません。

はじめに

前提条件

1. キャンペーンデータの生成 (Pythonバックエンド)

git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git
cd YOUR_REPO
pip install -r requirements.txt

cp .env.example .env
# fill in GEMINI_API_KEY and UNSPLASH_ACCESS_KEY in .env

1つのターミナルでMCPサーバーを起動します:

python server.py

別のターミナルでデモキャンペーンを実行します:

python run_demo.py               # all campaigns
python run_demo.py --campaign 1  # just one

これにより、各キャンペーンの出力が campaign_outputs/campaign_N/ に書き込まれます。

2. フロントエンドのビルドと実行

npm install
npm run build:demo-data   # reads campaign_outputs/, populates data/demos.ts + public/demos/
npm run dev

http://localhost:3000 を開きます。

パイプラインの実行 (BYOK)

デプロイされたサイトには、ビルド時に事前生成されたデモキャンペーンが組み込まれています。本番環境ではバックエンドは実行されません。誰でもこのリポジトリをクローンし、上記の手順に従って独自のAPIキーに対して同じパイプラインを実行できます。どちらのキーにも、有料アカウント、クレジットカード、承認プロセスは必要ありません。

デプロイメント

デプロイが必要なのはNext.jsフロントエンドのみです。Pythonバックエンドはローカル生成ツールであり、デプロイされたサイトのランタイム依存関係ではありません。自分で実行する手順のアプリ内バージョンについては、components/ByokPanel.tsxを参照してください。

Vercelにデプロイ: リポジトリをインポートすると、フレームワークが自動的にNext.jsとして検出されます。フロントエンドのビルドに環境変数は必要ありません。

ライセンス

MIT

著者

Nibha S Dongre によって構築されました — エンドツーエンドのエージェンティックMCPパイプライン。

[GitHubで見る →

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    An all-in-one AI content creation platform with 30 tools for generating images, videos, music, and managing enterprise social media and CRM. Enables content generation, image editing, e-commerce features, and social media management directly from MCP-compatible AI assistants.
    43
    4
    Apache 2.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI clients to compose and execute marketing campaigns by mapping free-form intent to a deterministic plan of over 1,000 production-tested skills, supporting multiple workflows across paid ads, SEO, content, and more.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to produce video commercials from product descriptions via a multi-stage pipeline with human-in-the-loop approval gates and explicit spend authorization.
    5
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Hosted MCP server that turns a one-line brief into finished, on-brand ad creative, including short video ads, product photos, and voiceover, with A/B variant testing and performance feedback loops.
    1
    -