codex-storyboard
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@codex-storyboard处理所有待生成素材"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Codex Storyboard
一个运行在本地、面向 Codex 工作流的视频分镜台。
你可以在网页里维护台词、画面提示词、A-ROLL / B-ROLL、素材类型和时长，再让 Codex 调用 Image Generation、HyperFrames 或 Remotion 生成素材并自动回填。
功能
多项目管理：新建、重命名、打开和删除项目
支持
9:16、16:9、3:4、4:3、1:1分镜表格：台词、画面描述、时长、素材类型和生成方式
图片与视频本地上传
图片 / 视频 Lightbox 放大预览
单镜头生成和批量生成队列
Codex MCP 自动领取任务并回填素材
Image Generation、HyperFrames、Remotion 路由
项目级
DESIGN.md视觉规范，可选导入、查看、替换和移除图片和视频生成任务自动应用项目视觉规范
所有项目和素材默认只保存在本机
Related MCP server: video-analyzer
快速开始
需要 Node.js 18 或更高版本。
git clone https://github.com/Yuuhann1999/codex-storyboard.git
cd codex-storyboard
npm start打开：
http://127.0.0.1:43218首次启动会自动创建本地数据目录：
data/
projects.json
projects/
<project-id>/
project.json
DESIGN.md
media/DESIGN.md 为可选文件，没有导入视觉规范的项目不会创建它。
安装 Codex 插件
仓库自带 codex-storyboard 插件和 Marketplace 配置。
codex plugin marketplace add Yuuhann1999/codex-storyboard
codex plugin add codex-storyboard@codex-storyboard安装后重新打开 Codex 对话，然后输入：
处理 Codex 分镜台里所有待生成素材也可以在 Codex 中引用插件：
@codex-storyboard 处理所有待生成素材插件会：
读取本地分镜台的待处理任务。
如果项目配置了
DESIGN.md，完整读取并作为统一视觉风格规范。根据
generator选择 Image Generation、HyperFrames 或 Remotion。使用项目的画面比例和输出尺寸生成素材。
将最终图片或视频回填到正确项目和镜头。
Image Generation、HyperFrames 和 Remotion 是否可用，取决于当前 Codex 环境中已启用的能力和插件。
手动安装本地插件
如果你在修改插件源码，可以把当前仓库注册为本地 Marketplace：
codex plugin marketplace add .
codex plugin add codex-storyboard@codex-storyboard插件源码位于：
plugins/codex-storyboard/
├── .codex-plugin/plugin.json
├── .mcp.json
├── mcp/server.mjs
├── scripts/start-mcp.sh
└── skills/process-storyboard-tasks/SKILL.md画面比例
项目比例同时作用于：
网页素材预览框
Image Generation 的目标比例
HyperFrames 的画布尺寸
Remotion 的画布尺寸
MCP 生成任务中的
aspectRatio、width和height
DESIGN.md 视觉规范
新建项目时可以选择导入一个 Markdown 文件作为项目视觉规范，也可以进入项目后通过右上角“视觉规范”菜单导入、查看、替换或移除。
导入后，文件统一保存为：
data/projects/<project-id>/DESIGN.md生成任务会同时携带该文件的绝对路径。插件生成图片或视频前会完整读取它：
分镜的“画面描述 / 生成提示词”决定当前镜头的具体内容
DESIGN.md统一约束视觉风格、色彩、构图、字体、质感和运动语言当前镜头的明确要求与通用规范冲突时，以当前镜头要求为准
HyperFrames 和 Remotion 的工程及中间文件保存在项目对应的
generation/目录
本地素材
“手动素材”镜头支持：
点击空素材框上传
使用“本地上传”按钮上传
点击已有素材放大查看
在 Lightbox 中重新上传替换
支持：
图片：PNG、JPEG、WebP、GIF
视频：MP4、WebM、MOV
单文件最大 100MB
项目结构
.
├── .agents/plugins/marketplace.json
├── plugins/codex-storyboard/
├── public/
├── docs/assets/
├── server.mjs
├── package.json
└── README.md网页使用原生 HTML、CSS 和 JavaScript，本地服务使用 Node.js 标准库，没有运行时 npm 依赖。
API
主要接口：
GET /api/projects
POST /api/projects
GET /api/projects/:projectId
PATCH /api/projects/:projectId
DELETE /api/projects/:projectId
GET /api/projects/:projectId/design
POST /api/projects/:projectId/design
DELETE /api/projects/:projectId/design
POST /api/projects/:projectId/shots
PATCH /api/projects/:projectId/shots/:shotId
DELETE /api/projects/:projectId/shots/:shotId
POST /api/projects/:projectId/shots/:shotId/media
GET /api/generation/tasks
POST /api/generation/tasks
POST /api/generation/tasks/:taskId/claim
POST /api/generation/tasks/:taskId/complete
POST /api/generation/tasks/:taskId/fail开发检查
npm run check验证插件：
python3 ~/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py \
plugins/codex-storyboard隐私
项目脚本和素材默认保存在本地
data/。仓库不会自动上传项目数据。
使用第三方生成能力时，提示词和输入素材可能受对应服务的隐私条款约束。
License
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Yuuhann1999/codex-storyboard'
If you have feedback or need assistance with the MCP directory API, please join our Discord server