distribea-mcp

Distribea 可以制作有你出镜的视频（Motion Control），并提供免版税的音乐、音效、视频素材和图像库。 这个软件包是面向创作者的品牌化 AI 媒体工具包：只需输入自然语言提示词，即可生成图像、视频、音乐和语音，并直接提供可用于生产环境的素材——采用经过优化的 WebP 格式，附带 SEO 替代文本，可为你下载，也可直接补丁式写入代码。一个连接器，四种媒体类型，三种使用方式：终端中的 CLI、供 AI 编码 Agent 在构建时调用的 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 工具
• 工作原理
• 计费与费用
• 隐私与安全
• 常见问题
• 故障排除
• 更新
• 支持
• 许可证

什么是 Distribea

大多数 AI 媒体工具只给你一个原始模型和一个空白提示词框，藏在浏览器标签页里，而且一次只能生成一张图像。Distribea 则更进一步——它就在你构建内容的地方。

• 一个连接器，四种媒体类型。 通过一次安装即可生成图像、视频、音乐和语音。大多数工具只能生成图像。
• 三种使用方式，一个引擎。 可从命令行运行（distribea …），将它作为 MCP 服务集成到你的 AI Agent（Claude Code、Cursor、Windsurf、Replit、Copilot）中，或添加 Claude Skill，让模型自动调用它。
• 默认契合品牌。 只需锁定一次品牌，所有素材都会保持一致。艺术总监会将一句主题描述扩展成完整提示词——你无需编写“如何呈现”。
• 可用于生产环境。 图像会以经过优化的 WebP 格式生成，并附带合适的 SEO 替代文本，可为你下载，也可直接补丁式写入页面。

繁重工作——艺术指导、生成和计费——都由托管的 Distribea 引擎负责。这个软件包只是本地连接器：它会扫描并修改你的文件，不保存 API 密钥或任何机密信息，生成内容的费用则按你 Distribea 方案中的积分和常规网站价格结算。

你可以创作的内容

媒体	命令	生成内容
🖼️ 图像	distribea image "<subject>"	一张符合品牌风格的图像（png/jpg），宽高比不限。人像、主视觉、产品图、插画、评论头像。
🎬 视频	distribea video "<subject>"	一段短视频（mp4）——文生视频，或根据参考照片生成图生视频。
🎵 音乐	distribea music "<style>"	一首可用于商业用途的曲目（mp3）——片头、背景音乐、广告配乐。
🎙️ 语音	distribea voice "<text>"	一段配音（mp3），支持多种语言的文本转语音。
📄 整页内容	distribea page [path]	为页面（或整个项目）中的每个 <img> 占位符生成符合品牌风格的内容，并行处理后写入代码。
✍️ 博客封面	distribea blog "<article>"	一张 16:9 封面图，以你的风格呈现文章的实际主题，并附带替代文本。

何时使用 Distribea

只要项目需要图像或音频，而你原本会使用库存图片、灰色占位图、纯 CSS 渐变区块或直接粘贴的原始照片，就可以使用 Distribea。常见用途：

• 你正在构建落地页，需要真正符合品牌风格的图像，而不是库存图片。
• 你需要电商产品图，并确保整个商品目录的风格一致。
• 你想要具有可信面孔的主视觉、团队肖像或客户评价头像。
• 你正在撰写博客文章，需要一张与文章和你的风格相匹配的封面图。
• 你需要一段用于主视觉或广告的短视频（文生视频或图生视频）。
• 你需要用于片头、演示或广告的背景音乐。
• 你需要用于演示、操作指南或视频旁白的配音。
• 你的网站满是廉价或不符合品牌风格的库存图片，想要直接替换并统一品牌形象。
• 你正在用 AI Agent 氛围编程，希望它在构建过程中自行填充媒体内容。

为什么选择 Distribea

	原始模型 CLI / MCP	通用图像 MCP	Distribea
图像 · 视频 · 音乐 · 语音	⚠️ 各不相同	❌ 仅图像	✅ 四种媒体，一个连接器
可在终端和 Agent 中使用	⚠️ 只能在其中一个使用	⚠️ 仅 MCP	✅ CLI · MCP · Skill
为你制定艺术指导	❌ 你要分别向每个模型编写提示词	⚠️ 每次都要编写提示词	✅ 内置艺术指导
一次锁定品牌风格	❌	⚠️ 每条提示词单独设置	✅ 应用于所有内容
不同场景中保持同一张脸	❌	❌	✅ 可重复使用的角色
一次调用填充整页内容	❌	❌	✅ distribea page
可用于生产环境（WebP + SEO 替代文本）	❌	❌	✅ 自动处理
连接器中不存储密钥/机密	⚠️ 保存你的模型密钥	⚠️ 各不相同	✅ 浏览器登录，无需粘贴密钥

**一句话总结：**其他工具只提供模型和提示词输入框；Distribea 则直接提供完成的、符合品牌风格的素材，涵盖你实际需要的四种媒体类型，无需离开你的工作环境。

安装

生成内容需要 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。添加一次后，每当页面需要图像或音频，你的 Agent 就会自行调用 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 可先预览价格（0 个积分，不会生成任何内容）。

符合品牌风格的图像

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

独立视频（文本生成视频）

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

背景音乐

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"> 标记来构建页面，然后只需调用一次，就能为 每个 位置填入符合品牌风格的图像——整个网站风格一致，重复出现的角色在每个场景中都拥有 同一张脸，还可以为评价版块生成可信的 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>"	生成一张可下载的图片（png/jpg）
distribea video "<subject>"	生成一段可下载的视频（mp4）
distribea music "<style>"	生成一首可下载的曲目（mp3）
distribea voice "<text>"	生成一段可下载的配音（mp3）
distribea page [path]	填充一个页面（或整个项目）——将占位内容替换为符合品牌风格的图片
distribea blog "<article>"	生成文章封面（16:9 + 替代文本）
distribea models [type]	浏览实时目录：image · video · music · voice
distribea call <tool> --k v	直接调用任意高级 MCP 工具（参见 MCP 工具）

运行 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	将图片保存为 jpg，而非 png
--dry-run	仅报价（0 积分）——显示价格，不生成内容

MCP 工具

作为 MCP 服务使用时，同一引擎会向你的 Agent 提供这些工具。Agent 会根据任务选择合适的工具；你只需描述需求。

工具	功能
make_images ⭐	并行填充页面（或整个项目）的所有占位内容／库存素材位置，生成符合品牌风格的图片；也可就地为现有图片重新打造品牌风格（rebrand: true）
bring_alive	让现有网站更生动：为没有图片的版块添加图片，并将库存图片／旧图片替换为符合品牌风格的图片（先提供免费方案，可撤销）
generate_image	生成一张符合品牌风格的图片（为评价头像自动切换到 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	一次调用生成 Logo、favicon 套件和 og:image
create_reference	锁定反复出现的角色（支持真实照片）或产品
finish_images	修复缺失的 ALT 文本，并将大型图片转换为 WebP（免费）
pack_status	当前风格、角色、积分
list_projects · link_project · forget_project	保存、重新连接或清除项目的品牌记忆（免费）

工作原理

1. 你提供主题——通过 CLI 命令，或由你的 Agent 在构建过程中调用工具。
2. 艺术总监将主题扩展为完整且符合品牌风格的提示词，并采用你锁定的风格——因此你无需亲自编写“具体方式”。
3. 最合适的模型生成素材（或使用你通过 --model 指定的模型）。
4. 你获得成品文件——下载到整洁的文件夹中，或以经过优化的 WebP 格式写入页面，并附上 SEO 替代文本，同时妥善保留原始文件。

每批任务都会在运行前以积分报价；--dry-run（CLI）或 dry_run（MCP）可预览价格，不会生成任何内容。连接器在本地运行，不保存任何机密信息；你的品牌记忆、生成的素材和账单都保存在托管的 Distribea 引擎上。

计费与成本

• 生成会根据你的 Distribea 套餐按点数计费；每批生成开始前都会以点数报价——先使用 --dry-run（CLI）或 dry_run（MCP）预览价格。
• 视频、音乐和语音需要付费套餐，渲染时间也更长。如果调用提示仍在渲染，请使用相同设置再次运行以获取结果——不会向你重复收费。
• 一次 page 调用即可为页面添加装饰；完成后任务即结束。Distribea 不会自行重新生成或“改进”素材——只有在你提出要求时才会进行润饰。

隐私与安全

此本地连接器不包含任何 API 密钥或机密信息。生成素材时，它只会向托管的 Distribea 引擎发送请求所需的信息：

• **发送的内容：**你的描述（你要求生成的主题）、正在处理的页面的一小段文本摘录（用于推断网站的风格和上下文）、经过哈希处理的项目标识符，以及你明确要求编辑的任何文件。项目中的其他文件会留在你的设备上——它们绝不会被读取或上传。
• **与你的帐户关联存储的内容：**你锁定的视觉风格、反复出现的角色／产品／头像、为你生成的素材（托管在 Distribea 的 CDN 上），以及你的点数／账单使用情况。
• 第三方：素材仅通过 Distribea 托管的 AI 服务提供商生成，以满足你的请求。你的数据绝不会被出售。
• **身份验证：**调用使用你的个人密钥（dmcp_…）进行身份验证。该密钥可在 distribea.com/account/mcp 申请并撤销。
• **数据保留与联系：**数据会保留至你的帐户注销；完整政策和联系方式请见 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 方案以积分计费；免费账户和试用账户都能获得几张赠送图片，用于体验。

它能生成视频、音乐和语音吗？还是只能生成图像？ 四种都能生成：图像、视频、音乐和语音，只需一个连接器。

它与原始图像模型或通用图像 MCP 有什么不同？ 内置的艺术指导会根据你的一句话主题撰写提示词；你的品牌设置只需锁定一次，就会应用到所有内容；不同镜头中的人脸和产品保持一致；一次调用即可填充整个页面——生成内容会以 WebP 格式补丁到你的代码中，并附带 SEO 替代文本。

它能使用我自己的照片吗？ 可以。传入 --ref 即可进行图生图或图生视频，还可以锁定某个人物或产品，让同一张脸／同一物体出现在每个场景中，同时改变场景布置。

它会修改我的代码或文件吗？ 只会修改你指定的文件。distribea page 会填充占位内容，并将其补丁到你的标记中；为现有图像重新打造品牌时，它会将原图保留为 *.original。它绝不会读取或上传你的其他文件。

它会生成哪些格式和宽高比？ 下载的素材为原生格式：图像为 png/jpg，视频为 mp4，音乐／语音为 mp3；放入页面的图像则会输出为优化后的 WebP。方向：16:9、9:16、1:1。

如何在生成前查看价格？ 添加 --dry-run（CLI）或 dry_run（MCP）。它会报出确切的积分费用，且不会生成任何内容（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，因此 Agent 设置会自动保持最新。

支持

Bug 和功能请求：github.com/Distribea/distribea-mcp/issues。密钥和文档：distribea.com/account/mcp。

许可证

MIT