mcpField
B
broll

broll

本地服务
github.com/luke-fairbanks媒体与设计515 周前更新
代码仓库

关于 broll

broll 是面向编码 Agent 的 MCP 服务，支持媒体生成、代码驱动的视频与轮播图渲染，以及社交平台发布。内容先保存为草稿供审核，发布必须经过明确确认。

主要功能

  1. 01使用自带 API key 生成媒体
  2. 02根据声明式计划渲染视频
  3. 03以代码布局创建品牌轮播图
  4. 04导入并检查媒体素材
  5. 05创建并校验平台专属帖子草稿
  6. 06仅在明确确认后发布

适用场景

  1. 01用媒体素材制作带字幕的预告视频
  2. 02为 Instagram 或 LinkedIn 渲染品牌幻灯片
  3. 03发布前生成供审核的帖子素材包
  4. 04发送帖子前检查平台限制

MCP 相关

broll 通过 MCP 服务向 MCP 客户端（包括编码 Agent）提供内容制作与发布工具。发布前须审核草稿并明确确认。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "luke-fairbanks-broll": {
      "command": "npx",
      "args": [
        "-y",
        "broll-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "BLUESKY_IDENTIFIER": "<BLUESKY_IDENTIFIER>",
        "BLUESKY_APP_PASSWORD": "<BLUESKY_APP_PASSWORD>",
        "MASTODON_ACCESS_TOKEN": "<MASTODON_ACCESS_TOKEN>",
        "X_API_KEY": "<X_API_KEY>",
        "X_API_SECRET": "<X_API_SECRET>",
        "X_ACCESS_TOKEN": "<X_ACCESS_TOKEN>",
        "X_ACCESS_TOKEN_SECRET": "<X_ACCESS_TOKEN_SECRET>"
      }
    }
  }
}
启动命令npx -y broll-mcp
需要配置的环境变量
OPENAI_API_KEY密钥Optional: gpt-image-1 image generation
GEMINI_API_KEY密钥Optional: Imagen images + Veo video
BLUESKY_IDENTIFIEROptional: Bluesky handle for live posting
BLUESKY_APP_PASSWORD密钥Optional: Bluesky app password
MASTODON_ACCESS_TOKEN密钥Optional: Mastodon app token for live posting
X_API_KEY密钥Optional: X consumer key (posting requires funded API credits)
X_API_SECRET密钥Optional: X consumer secret
X_ACCESS_TOKEN密钥Optional: X access token (Read and write)
X_ACCESS_TOKEN_SECRET密钥Optional: X access token secret

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmbroll-mcp0.1.1

工具

14

收录的工具列表 · 更新于 2 周前

参数类型必填说明
probeboolean否实时验证社交平台凭据（不会发布内容）

详细介绍

broll

面向编码 Agent 的内容工作室 MCP。 broll 让 Claude Code、Codex 和任何 MCP 客户端都能真正动手制作内容：使用你自己的 API 密钥生成媒体，通过代码以确定的方式渲染视频和轮播图，并通过先存草稿的发件箱发布。

模型负责规划。代码负责渲染。未经确认，绝不发布。

为什么选择 broll

每个运行编码 Agent 的开发者都会遇到同一个瓶颈：Agent 能写营销方案，却无法制作轮播图、剪辑视频或发布内容。现有工具都是按额度计费、面向社交媒体经理的排程工具。broll 专为开发者打造：

  • 使用自己的密钥，不加价。 图片和视频生成直接使用你的 OPENAI_API_KEY / GEMINI_API_KEY。broll 绝不会代理你的推理请求或转售额度。内置的模拟提供商让你无需添加任何密钥，也能运行所有工作流。
  • 确定性渲染。 视频和幻灯片会根据声明式计划编译为精确的 ffmpeg/sharp 调用。同一计划 + 相同输入 = 相同输出。当 AI 输出出现偏差时，用代码修正即可——因此，布局、字体、字幕和品牌元素都由代码控制。
  • 先存草稿，再发布。 帖子以可审核的 JSON 文件形式保存在发件箱中。publish_post 要求 confirm: true，会在任何内容离开设备之前验证各平台规则（字符数限制、媒体数量、文件大小），并报告各平台的结果。export 平台始终可用：它会生成可直接发布的内容包。

安装

需要 Node 20+ 和 ffmpeg（brew install ffmpeg）。

cd broll
npm install && npm run build

在 Claude Code 中注册（或在此仓库中工作时使用仓库内的 .mcp.json）：

claude mcp add broll -- node /path/to/broll/dist/index.js

可选环境变量：

变量用途
OPENAI_API_KEY使用 gpt-image-1 生成图片
GEMINI_API_KEY使用 Imagen 生成图片 + 使用 Veo 生成视频
BLUESKY_IDENTIFIER / BLUESKY_APP_PASSWORD发布到 Bluesky（使用应用密码）
MASTODON_ACCESS_TOKEN（+ 可选的 MASTODON_INSTANCE）发布到 Mastodon——无需应用审核，支持任何实例
X_API_KEY / X_API_SECRET / X_ACCESS_TOKEN / X_ACCESS_TOKEN_SECRET发布到 X（免费 API 层级即可使用）
BROLL_HOME工作区位置（默认 ~/.broll）
BROLL_FFMPEG / BROLL_FFPROBE指定二进制文件路径

品牌套件：在服务运行位置旁放置一个 broll.config.json（示例见此仓库）——包含名称、账号名、颜色、字体和徽标。每次渲染都会自动应用这些设置。

工具

工具功能
broll_status工作区、ffmpeg、提供商及平台的就绪状态。请先调用。
generate_image / generate_video使用自己的密钥生成内容 → 工作区资源（无密钥时回退到模拟模式）
import_asset / list_assets / probe_asset导入并检查媒体
render_video声明式 RenderPlan → mp4：片段（视频/图片/纯色）、裁剪、cover/contain 适配、烧录标题 + 定时字幕、背景音乐、9:16 / 1:1 / 4:5 / 16:9
render_carousel品牌幻灯片组（适用于 Instagram/LinkedIn 的格式）：引导语、标题、正文、强调色条、页码、水印——布局完全由代码控制
extract_frame提取 PNG 帧，让 Agent 直观检查自己的渲染结果
create_post_draft文本 + 媒体 + 平台 → 已验证、可审核的发件箱草稿
list_drafts / publish_post检查发件箱；通过明确设置 confirm: true 发布

试用

npm run smoke

通过真正的 MCP 客户端驱动实际服务：生成背景，渲染 3 张幻灯片的轮播图和带字幕的 9:16 预告视频，提取 QA 帧，然后创建草稿并“发布”一个导出内容包——所有文件都保存到 ./.broll/。

broll cloud（候补名单）

你正在查看的本地服务仍采用 MIT 许可且免费。broll cloud 增加了本地服务难以胜任的功能：通过 broll 自己获批的凭证接入需要应用审核的平台（Instagram、LinkedIn、TikTok）；在笔记本电脑关闭时也能运行的定时任务；以及可在手机上滑动批准的收件箱。上线后约为每月 29 美元。

加入候补名单 → 👍 issue #1 — 订阅者会收到上线通知；评论将决定平台的开发顺序。

安全模型

  1. 只有先在磁盘上创建草稿文件，内容才会发布。
  2. publish_post 强制要求 confirm: true ——— Agent 会被指示先征得用户明确同意。
  3. 违反约束会阻止发布；系统绝不会自动截短你的文本。
  4. 密钥从你的环境中读取，且只会发送给对应供应商的 API。

状态与路线图

项目仍处于早期阶段，但已可运行：共有 96 项测试，包括真实的 ffmpeg 集成渲染和完整的 MCP 往返测试。

  • Bluesky 视频上传
  • X 分块视频上传
  • LinkedIn 适配器（需要应用审核）
  • Mastodon 适配器
  • 通过用户 OAuth 上传 YouTube Shorts
  • Ken Burns / 交叉淡化转场
  • 根据转录文本生成逐词字幕时间
  • npx broll-mcp 分发

开发

npm test          # unit + integration (real ffmpeg)
npm run typecheck
npm run smoke     # end-to-end artifact check

MIT。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。