distribea-mcp

Distribea は、あなたが映った動画を作り直す (Motion Control) ほか、ロイヤリティフリーの音楽、効果音、映像素材、画像ライブラリを提供します。 このパッケージは、ビルダー向けのDistribeaブランドの AI メディアツールキットです。自然言語のプロンプトから画像、動画、音楽、音声を生成し、本番ですぐ使える形で提供します。WebP に最適化し、SEO 向けの代替テキストを付けてダウンロードするか、コードに直接反映できます。1つのコネクターで4種類のメディアを、CLI でターミナルから、AI コーディングエージェントが開発中に呼び出す MCP サーバーとして、または Claude Skill として利用できます。ブランドを一度設定すれば、組み込みのAI アートディレクターがすべてのプロンプトを作成します。あなたが伝えるのは求めるものだけで、描画方法を指定する必要はありません。通常のサイト価格でクレジット請求されます。このコネクターは API キーも秘密情報も保持しません。

npm install -g distribea-mcp
distribea login                                       # opens your browser — no key to paste

distribea image "founder portrait, soft daylight"  --portrait
distribea video "slow waves rolling at golden hour" --landscape
distribea music "warm lo-fi beat, mellow, 90 bpm"
distribea voice "Welcome to our store."             --lang en

各ファイルは、すぐに使えるよう整理されたフォルダーに保存されます。任意のコマンドに --dry-run を追加すると、実行前に正確なクレジット価格を確認できます（クレジット消費は0で、生成も行いません）。

---

目次

• Distribea とは
• 作成できるもの
• Distribea を使う場面
• Distribea を選ぶ理由
• インストール
• クイックスタート
• 使用例とレシピ
• ページ全体を装飾する
• 繰り返し登場する人物と製品
• モデル
• コマンドリファレンス
• フラグ
• MCP ツール
• 仕組み
• 請求と料金
• プライバシーとセキュリティ
• FAQ
• トラブルシューティング
• 更新
• サポート
• ライセンス

Distribea とは

多くの AI メディアツールでは、ブラウザーのタブで生のモデルと空のプロンプト欄が用意され、画像を1枚ずつ生成します。Distribea はその上位レイヤーであり、開発する場所で使えます。

• 1つのコネクターで4種類のメディアに対応。 画像、動画、音楽、音声を1回のインストールで利用できます。多くのツールは画像までしか対応していません。
• 3通りの使い方、1つのエンジン。 シェルから実行する (distribea …)、MCP サーバーとしてAI エージェントに組み込む（Claude Code、Cursor、Windsurf、Replit、Copilot）、または Claude Skill を追加して、モデルが自ら呼び出せるようにします。
• 初期設定からブランドに準拠。 ブランドを一度固定すれば、すべての素材に反映されます。アートディレクターが1行の題材から詳細なプロンプトを作成するため、「方法」を自分で書く必要はありません。
• 本番ですぐに使える品質。 画像は適切な SEO 向け代替テキスト付きの最適化済み WebP として生成され、ダウンロードするか、ページに直接反映できます。

アートディレクション、生成、請求などの処理は、ホスト型の Distribea エンジンで実行されます。このパッケージはローカルコネクターにすぎません。あなたのファイルをスキャンして変更しますが、API キーも秘密情報も保持せず、生成料金は通常のサイト価格に基づき、Distribea プランのクレジットで請求されます。

作成できるもの

メディア	コマンド	生成されるもの
🖼️ 画像	distribea image "<subject>"	ブランドイメージに合った画像を1枚（png/jpg）。アスペクト比は自由です。人物写真、ヒーロー画像、商品写真、イラスト、レビュー用アバターなどに使えます。
🎬 動画	distribea video "<subject>"	短い動画クリップを1本（mp4）。テキストからの動画生成、または参照写真からの画像から動画への生成に対応します。
🎵 音楽	distribea music "<style>"	ロイヤリティフリーで使える楽曲を1曲（mp3）。イントロ、BGM、広告用の音楽などに使えます。
🎙️ 音声	distribea voice "<text>"	ナレーション音声を1本（mp3）。多言語のテキスト読み上げに対応します。
📄 ページ全体	distribea page [path]	ページ（またはプロジェクト全体）のすべての<img>プレースホルダーをブランドイメージに合わせて並列に生成し、コードに適用します。
✍️ ブログカバー	distribea blog "<article>"	記事の実際の内容を表す16:9のカバー画像を、指定のスタイルで生成します。代替テキストも付属します。

Distribea の利用シーン

プロジェクトで画像や音声が必要になったとき、ストック写真、グレーのプレースホルダー、CSS グラデーションだけのセクション、貼り付けただけの写真を使う代わりに、Distribea を活用してください。よくある用途は次のとおりです。

• ランディングページを作成していて、ストック画像ではなく、ブランドイメージに合った本物の画像が必要なとき。
• カタログ全体で一貫性のあるEC 商品写真が必要なとき。
• 信頼感のある顔写真を使ったヒーロー画像、チームのポートレート、推薦文のアバターが必要なとき。
• ブログ記事を執筆していて、記事の内容とスタイルに合ったカバー画像が必要なとき。
• ヒーローや広告に使う短い動画クリップ（テキストからの動画生成、または画像からの動画生成）が必要なとき。
• イントロ、デモ、広告に使うBGMが必要なとき。
• デモ、操作ガイド、動画のナレーションに使うナレーション音声が必要なとき。
• 安っぽい、またはブランドイメージに合わないストック写真だらけのサイトを、既存の場所でブランドに合わせて作り直したいとき。
• AI エージェントとバイブコーディングをしていて、構築中にメディアを自動で補完してほしいとき。

Distribea を選ぶ理由

	生のモデル CLI / MCP	汎用画像 MCP	Distribea
画像・動画・音楽・音声	⚠️ 対応状況はさまざま	❌ 画像のみ	✅ 4種類すべてに1つのコネクターで対応
ターミナルとエージェントから利用可能	⚠️ どちらか一方	⚠️ MCP のみ	✅ CLI・MCP・Skill
アートディレクションを自動で作成	❌ モデルごとにプロンプトを入力	⚠️ プロンプトごと	✅ アートディレクターを内蔵
ブランド設定を一度で固定	❌	⚠️ プロンプトごと	✅ すべてに適用
シーン間で同じ顔を維持	❌	❌	✅ 登場人物を繰り返し使用
1回の呼び出しでページ全体を補完	❌	❌	✅ distribea page
本番環境対応（WebP + SEO 向け代替テキスト）	❌	❌	✅ 自動
コネクターにキーやシークレットを保存しない	⚠️ モデルのキーを保持	⚠️ 対応状況はさまざま	✅ ブラウザーでサインインするだけ。貼り付け不要

**一言で言えば：**ほかのツールがモデルとプロンプト入力欄を提供するのに対し、Distribea は、制作環境を離れることなく、必要な4種類のメディアで完成済みのブランドイメージに合った素材を提供します。

インストール

生成にはDistribeaのプランが必要です（無料アカウントまたはトライアルアカウントでは、お試し用のギフト画像を数枚利用できます）。コネクター自体は無料で、シークレットを保存しません。

CLI（推奨）

npm install -g distribea-mcp
distribea login          # opens your browser, click Authorize — no key to paste

distribea whoamiを実行して、接続されていることを確認します。

MCP サーバー

プロジェクトのルートにある.mcp.jsonに、次の内容を追加します。

{
  "mcpServers": {
    "distribea-mcp": {
      "command": "npx",
      "args": ["-y", "distribea-mcp@latest"],
      "env": {
        "DISTRIBEA_MCP_KEY": "dmcp_…"
      }
    }
  }
}

distribea.com/account/mcpでdmcp_…キーを取得してください。すでにdistribea loginを実行している場合、サーバーはそのセッションを再利用するため、envブロックを省略できます。

ツール	追加する場所
Claude Code	claude mcp add distribea-mcp -e DISTRIBEA_MCP_KEY=dmcp_… -- npx -y distribea-mcp@latest
Cursor	Settings → MCP → Add、またはブロックを~/.cursor/mcp.jsonに貼り付けます
Windsurf	~/.codeium/windsurf/mcp_config.jsonに貼り付けます
VS Code (Copilot)	.vscode/mcp.jsonに貼り付けます
Replit	上記のコマンドを使って、カスタム MCP サーバーとして追加します

Claude Skill

パッケージにはSKILL.mdが含まれています。一度追加すれば、ページに画像や音声が必要なとき、エージェントが自動でDistribeaを利用します。

npx skills add Distribea/distribea-mcp

クイックスタート

npm install -g distribea-mcp
distribea login
distribea image "a quiet beach at sunrise, warm light" --landscape

ファイルは使いやすく整理されたフォルダーに保存されます。これだけです。モデルを選ぶ必要も、プロンプトを工夫する必要もありません。スタイルは自動で推測され、アートディレクターがプロンプトを作成します。ここから、image を video、music、voice に置き換えるか、distribea page を実行してページ全体を一度に仕上げられます。

例とレシピ

すべてのコマンドには、平易な言葉で題材を指定します。まず価格を確認するには --dry-run を追加してください（クレジット消費なし、生成も行われません）。

ブランドイメージに合った画像

distribea image "founder portrait, soft daylight, neutral background" --portrait

単体の動画（テキストから動画を生成）

distribea video "slow waves rolling onto a tropical beach" --landscape

BGM

distribea music "warm lo-fi beat, mellow, 90 bpm" --out ./assets

ナレーション（テキスト読み上げ）

distribea voice "Welcome to our store — let's get you started." --lang en

参照写真 → 画像または動画（画像から画像／画像から動画）

実際の写真を新しいブランドイメージに合った画像に変換したり、アニメーション化したりできます。--ref は一度だけ指定するか、複数の参照画像を使う場合は複数回指定します。選択したモデルが受け付ける数に合わせて、自動的に上限が設定されます。

distribea image "the same product on a marble kitchen counter" --ref ./bottle.jpg
distribea video "gentle push-in on the cliff at golden hour" --ref ./cliff.jpg --portrait

ブログのカバー画像

記事を読み取り、特定の題材を反映した画像を、固定されたスタイルに合わせて、16:9 の WebP と代替テキストで作成します。

distribea blog "How we cut our build times in half — full article body here…"

特定のモデルを選択

デフォルト設定は優れています。特定のモデルを使いたい場合にのみ、モデル名を指定してください。

distribea image "minimalist blue logo on white" --model nano-banana-pro --dry-run

最新カタログを確認（無料）

distribea models image      # or: video | music | voice

ページ全体を仕上げる

ページのワークフローは大きな強みです。画像を配置する場所に <img src="https://placehold.co/1200x600"> マーカーを入れてページを作成すると、1 回の呼び出しですべてのスロットにブランドに合った画像が生成され、サイト全体で統一感のある見た目になります。繰り返し登場するキャラクターはすべてのシーンで同じ顔になり、レビュー欄には本物らしい UGC アバターを配置できます。

distribea page ./index.html      # omit the path to dress the whole project

生成される画像はすべて、そのまま本番環境で使える状態です。最適化済みの WebP、適切な SEO 向け代替テキスト、そしてコードへの直接反映が含まれます。ストック写真も、プレースホルダーも、エクスポート作業も必要ありません。スタイルはページ自体から推測されるため、設定は不要です。

安価なストック写真やブランドに合わないストック写真を使っているサイトがすでにある場合は、既存の画像をそのまま差し替えてリブランドできます。最初の実行では、差し替え可能な画像がすべて無料で一覧表示され、その後、コードに手を加えず新しいスタイルを適用します（元の画像は *.original として保存されます）。

繰り返し登場する人物と製品

実在の人物（創業者や教師など）や、すべてのショットで見た目を同一に保つ必要がある製品は、固定された被写体として扱われます。顔やオブジェクトは 100% 同一に保ち、演出だけを変更します。

distribea image "the teacher explaining at a whiteboard" --ref ./founder.jpg

写真をそのままページに貼り付けないでください。プレースホルダーを配置し、エンジンにその顔をサイトの世界観に合わせて再演出させます。レビューや推薦文のアバターは、スマートフォンで気軽に撮影した自撮り写真（UGC スタイル）として生成され、同じレビュアーはサイト内のどこでも同じ顔で表示されます。

モデル

生成には最高水準のプロバイダーを使用し、メディアの種類ごとにブランドに合った優れたデフォルトモデルが設定されているため、モデル名を指定する必要はほとんどありません。

種類	デフォルト	利用可能なプロバイダーの一例
画像	Nano Banana Pro（2K）	Nano Banana Pro · Seedream · Z-Image · Grok Image
動画	Grok Imagine（6s、720p）	Grok · Seedance · Veo · Sora
音楽	MiniMax Music	MiniMax · CassetteAI
音声	ElevenLabs Multilingual v2	ElevenLabs · MiniMax

カタログは常に最新の状態です。distribea models image|video|music|voice（無料）を実行するか、MCP 経由で list_models / list_video_models / list_music_models / list_voice_models を使うと、最新のモデル、各モデルの得意分野、オプション、参考価格を確認できます。

コマンドリファレンス

コマンド	用途
distribea login [key]	接続します。ブラウザーが開きます。または、dmcp_… キーを直接渡します
distribea whoami · logout	保存済みのセッションを確認／削除します
distribea image "<subject>"	ダウンロード可能な画像を1点生成します（png/jpg）
distribea video "<subject>"	ダウンロード可能な動画を1点生成します（mp4）
distribea music "<style>"	ダウンロード可能なトラックを1点生成します（mp3）
distribea voice "<text>"	ダウンロード可能なナレーションを1点生成します（mp3）
distribea page [path]	ページ（またはプロジェクト全体）を埋めます。プレースホルダーをブランドに合った画像に置き換えます
distribea blog "<article>"	記事のカバー画像を生成します（16:9 + alt テキスト）
distribea models [type]	最新のカタログを閲覧します：image · video · music · voice
distribea call <tool> --k v	高度な MCP ツールを直接呼び出します（MCP toolsを参照）

全リファレンスを確認するには、distribea helpを実行してください。

フラグ

フラグ	用途
--model <id>	特定のモデルを選択します（distribea modelsを参照）
--ref <file>	参照画像を指定します。画像から画像／画像から動画への生成に使用します（複数指定する場合は繰り返します）
--format <r>	16:9（横長） · 9:16（縦長） · 1:1（正方形）
--portrait · --landscape · --square	向きを簡単に指定します
--lang <code>	音声の言語（例：en、fr）
--out <dir>	ファイルのダウンロード先
--jpg	画像を png の代わりに jpg で出力します
--dry-run	見積もりのみ（クレジット消費なし）。料金を表示し、何も生成しません

MCP ツール

MCP サーバーとして使用すると、同じエンジンがこれらのツールをエージェントに公開します。エージェントが作業に適したツールを選ぶので、必要なものを説明するだけでかまいません。

ツール	機能
make_images ⭐	ページ（またはプロジェクト全体）のプレースホルダー／ストック画像枠をすべて、ブランドに合った画像で並列に埋めます。または、既存画像をその場でブランドに合わせて変更します（rebrand: true）
bring_alive	既存のサイトに活気を加えます。画像のないセクションに画像を追加し、ストック画像や古い画像をブランドに合ったものに置き換えます（無料で事前に提案し、元に戻せます）
generate_image	ブランドに合った画像を1点生成します（レビュー用アバターには自動で UGC セルフィーモードを適用します）
generate_with_model	選択したモデルと設定で単独の画像を生成し、ネイティブの png/jpg としてダウンロードします
generate_video	選択したモデルで単独の動画を生成し、ネイティブの mp4 としてダウンロードします
generate_music	単独の音楽トラックを生成し、mp3 としてダウンロードします
generate_voice	単独のナレーション（テキスト読み上げ）を生成し、mp3 としてダウンロードします
list_models · list_video_models · list_music_models · list_voice_models	生成前にカタログ（ID、得意分野、オプション、参考価格）を閲覧します（無料）
edit_image	レタッチ、再生成、背景の削除、×4 のアップスケール、拡張を行います
blog_cover	ブログ記事用に、ブランドに合ったカバー画像を生成します
site_style	サイトのビジュアルアイデンティティを固定、調整、または基準として設定します
brand_pack	ロゴ、ファビコン一式、og:image を1回の呼び出しで生成します
create_reference	繰り返し登場するキャラクター（実際の写真にも対応）または製品を固定します
finish_images	欠落している ALT テキストを補い、容量の大きい画像を WebP に変換します（無料）
pack_status	現在のスタイル、キャラクター、クレジットを確認します
list_projects · link_project · forget_project	プロジェクトのブランドメモリーを保存、再接続、または消去します（無料）

動作の仕組み

1. テーマを指定します — CLI コマンドを実行するか、エージェントが作業中にツールを呼び出します。
2. アートディレクターが内容を膨らませます。固定済みのスタイルを使って、ブランドに合った完全なプロンプトを作成するので、「どのように」を手書きする必要はありません。
3. 最適なモデルがアセットを生成します（または、--modelで指定したモデルを使用します）。
4. 完成したファイルを受け取れます。整理されたフォルダーにダウンロードするか、ページ内に最適化済みの WebP として反映できます。SEO 対応の alt テキストを付け、オリジナルは安全に保管します。

すべてのバッチは、実行前にクレジットで見積もられます。--dry-run（CLI）またはdry_run（MCP）を使うと、料金をプレビューでき、何も生成されません。コネクターはローカルで実行され、秘密情報を保持しません。ブランドメモリー、生成したアセット、請求情報は、ホスト型の Distribea エンジン上で管理されます。

請求と費用

• 生成にはDistribeaのプランに応じたクレジットが課金されます。各バッチは開始前にクレジット数が提示されます。事前に料金を確認するには、--dry-run（CLI）またはdry_run（MCP）を使用してください。
• 動画、音楽、音声の生成には有料プランが必要で、レンダリングにも時間がかかります。呼び出し結果にまだレンダリング中と表示された場合は、同じ設定で再度実行して処理を続けてください。二重に課金されることはありません。
• pageを1回呼び出すと、ページが仕上がります。これで作業は完了です。Distribeaが独自にアセットを再生成したり「改善」したりすることはありません。修正は依頼した場合にのみ行われます。

プライバシーとセキュリティ

このローカルコネクターには、APIキーやシークレットは含まれていません。アセットを生成する際、ホスト型のDistribeaエンジンに送信されるのは、リクエストに必要な情報だけです。

• 送信される情報： 指示内容（依頼する対象）、作業対象のページから抜粋した短いテキスト（サイトのスタイルや文脈の推測に使用）、ハッシュ化されたプロジェクト識別子、および編集を明示的に依頼したファイルです。プロジェクト内のその他のファイルはお使いのマシンに残り、読み取られたりアップロードされたりすることはありません。
• アカウントに紐付けて保存される情報： 固定したビジュアルスタイル、繰り返し登場するキャラクター／製品／アバター、お客様向けに生成されたアセット（DistribeaのCDNでホスト）、クレジットの利用状況と請求情報です。
• 第三者： アセットの生成には、リクエストの遂行のみを目的として、Distribeaのホスト型AIプロバイダーを利用します。お客様のデータが販売されることはありません。
• 認証： 呼び出しは、distribea.com/account/mcpで発行・失効できる個人キー（dmcp_…）で認証されます。
• データの保持とお問い合わせ： データはアカウントの存続期間中保持されます。ポリシー全文およびお問い合わせ先は、distribea.com/legal/privacy-policyをご覧ください。

よくある質問

Distribea MCP とは何ですか？ 自然な言葉によるプロンプトから画像、動画、音楽、音声を生成する、ブランドイメージに沿った AI メディアツールキットです。CLI、MCP サーバー、Claude Skill として利用できます。通常のサイト価格で、本番環境ですぐに使えるアセット（WebP ＋ SEO 用代替テキスト）を提供します。

どの AI コーディングツールで使えますか？ Claude Code、Cursor、Windsurf、Replit、GitHub Copilot など、MCP に対応するツールで使えます。あらゆるターミナルで通常の CLI としても実行できます。

API キーは必要ですか？ いいえ。distribea login を実行すると、ブラウザー経由でサインインできます。貼り付けるものはありません。MCP／ホスト型のセットアップでは、アカウントで発行・失効できる個人用の dmcp_… キーを使用します。

無料ですか？ コネクターは無料で、シークレット情報を保存しません。生成には Distribea のプランに応じたクレジットが必要です。無料アカウントとトライアルアカウントでは、お試し用にギフト画像を数点ご利用いただけます。

動画、音楽、音声も生成できますか？画像だけですか？ 1 つのコネクターで、画像、動画、音楽、音声のすべてを生成できます。

生の画像モデルや汎用画像 MCP とはどう違いますか？ 組み込みのアートディレクターが、1 行の被写体指定からプロンプトを作成します。ブランドイメージを一度固定すると、すべてに適用されます。撮影ごとに人物や製品の外見が変わることはありません。また、1 回の呼び出しでページ全体を埋められ、SEO 用代替テキスト付きの WebP としてコードに反映されます。

自分の写真を使えますか？ はい。画像から画像、または画像から動画を生成する場合は --ref を渡してください。人物や製品を固定すると、構成を変えながら、すべてのシーンで同じ顔やオブジェクトを使用できます。

コードやファイルは変更されますか？ 指定したファイルのみ変更されます。distribea page はプレースホルダーを埋めてマークアップに反映します。既存の画像をブランドイメージに合わせて変更する場合は、元の画像を *.original として保持します。それ以外のファイルを読み込んだり、アップロードしたりすることはありません。

どの形式とアスペクト比で生成されますか？ ダウンロードしたアセットは、ネイティブ形式では画像が png／jpg、動画が mp4、音楽／音声が mp3 です。ページに配置される画像は最適化された WebP になります。向きは 16:9、9:16、1:1 です。

生成前に料金を確認するにはどうすればよいですか？ （CLI）では --dry-run を、（MCP）では dry_run を追加します。正確なクレジット料金が表示され、何も生成されません（クレジット消費は 0 です）。

呼び出しに「レンダリング中」と表示されます。二重に課金されますか？ いいえ。動画、音楽、音声の生成には時間がかかります。結果を取得するには、まったく同じコマンドを再実行してください。二重に課金されることはありません。

どのモデルを使用しますか？ メディアの種類ごとに、ブランドイメージに合った高性能なデフォルトモデルを用意しています（例：画像には Nano Banana Pro、動画には Grok Imagine、音楽には MiniMax、音声には ElevenLabs）。最新カタログを確認し、--model でモデルを上書きできます。

トラブルシューティング

No Distribea key ／ Not authenticated — distribea login を実行してください（または、MCP／ホスト型のセットアップでは DISTRIBEA_MCP_KEY を設定してください）。

Unknown model "<name>" — 最新カタログを確認するには、distribea models image|video|music|voice を実行してください。

呼び出しに「レンダリング中」と表示される — 動画／音楽／音声の生成には時間がかかります。結果を取得するには、まったく同じコマンドを再実行してください。二重に課金されることはありません。

更新

npm install -g distribea-mcp@latest

MCP サーバーは npx を介して @latest を自動的に取得するため、エージェントのセットアップは自動で最新の状態に保たれます。

サポート

バグ報告と機能リクエスト：github.com/Distribea/distribea-mcp/issues。キーとドキュメント：distribea.com/account/mcp。

ライセンス

MIT