cogvideox-drama-mcp
An MCP server that turns drama scripts into storyboard shots and generates videos for each shot using Zhipu CogVideoX, returning timed download URLs. It can be integrated with MCP-compatible agents like LangChain, Dify, Cline, and Cherry Studio.
README
漫剧生成 MCP 工具
基于 MCP(模型上下文协议) 的漫剧视频生成工具。输入一段剧本,自动拆分成镜头,调用视频大模型逐个生成分镜视频片段,返回每个分镜的视频下载地址。
功能特性
- 🎬 剧本 → 自动分镜 → 逐镜生成视频(全自动流水线)
- 🤖 DeepSeek 智能分镜(未配置时自动降级为兜底拆分)
- 🎥 视频生成基于智谱 CogVideoX(
cogvideox-3) - 🔧 视频模型与分镜 LLM 均可自由替换(换 Key、换地址、换模型名即可,代码零改动)
- ⚡ 异步任务模式:提交 → 轮询 → 返回视频 URL
快速开始
1. 安装
pip install uv # 客户端需先装 uv(若已有可跳过)
pip install cogvideox-drama-mcp
2. 配置环境变量
以下环境变量按「智谱 CogVideoX 视频生成 + DeepSeek 智能分镜」的默认方案配置。 本工具的视频模型与分镜模型均为可替换设计:替换对应的 API Key、Base URL 与模型名,即可切换到其他视频生成或 LLM 服务,代码无需改动。
| 变量 | 作用 | 当前示例 | 可替换为 |
|---|---|---|---|
SEEDANCE_API_KEY |
视频模型鉴权 | 智谱 API Key | 其他服务商的 Key |
SEEDANCE_BASE_URL |
视频服务地址 | https://open.bigmodel.cn/api/paas/v4 |
对应服务商地址 |
SEEDANCE_MODEL |
视频模型名 | cogvideox-3 |
其他模型名 |
OPENAI_API_KEY |
分镜 LLM 鉴权 | DeepSeek Key | 任意 OpenAI 兼容 LLM |
OPENAI_BASE_URL |
分镜 LLM 地址 | https://api.deepseek.com/v1 |
对应服务地址 |
3. 接入 MCP 客户端
以 Cherry Studio / Cline / Cursor 为例:
{
"mcpServers": {
"cogvideox-drama": {
"command": "uvx",
"args": ["cogvideox-drama-mcp"]
}
}
}
工具说明
generate_drama(script, shot_count)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
script |
string | 是 | 漫剧剧本(一段文字) |
shot_count |
int | 否 | 拆分镜头数,默认 3 |
示例:
输入剧本:一名少女在雨夜捡到一只发光的小猫,从此能听见别人的心声。
返回:
{
"title": "心声之猫",
"shots": [
{"index": 1, "video_url": "https://.../shot1.mp4"},
{"index": 2, "video_url": "https://.../shot2.mp4"},
{"index": 3, "video_url": "https://.../shot3.mp4"}
]
}
注意事项
- 单个分镜视频最长约 15 秒,更长的剧情需拆多个分镜
- 生成的视频 URL 有时效,请及时保存
- 视频生成耗时约 1-5 分钟(异步轮询),请耐心等待
- API Key 为调用者私有配置,请勿提交到公共仓库
许可
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.