Short Video MCP

短视频MCP服务器

停止阅读冗长的人工智能答案。而是看着他们。

将任何克劳德的答案、PDF、PowerPoint、电子邮件或主题转换为TikTok风格的短视频，由 彼得·格里芬 和 斯特威·格里芬 --具有游戏背景、角色动画和同步字幕。

Example Output

为什么？

克劳德刚刚给了你一个两页的答案？别读了，说 “生成短视频” 彼得和斯特维将在60秒后向你解释。

这不仅限于一个用例。 它转动 *任何* 在视频中回答：

• 不想读克劳德的长篇大论吗？ → 只需添加“生成短视频”并观看即可
• 你老师给你60张幻灯片了吗？ → 上传它，让克劳德为每张幻灯片生成一个视频——现在滚动浏览短视频而不是幻灯片
• 想从PDF学习吗？ → 上传它，生成一个视频——每个关键事实、日期和细节都包括在内，这样你就不会错过任何东西
• 是否已设置Gmail MCP？ → 让克劳德阅读你的收件箱并制作一段短视频——彼得和斯特维会及时回复你的电子邮件
• 上午简报会？ → 制定一个时间表，并获得由Peter和Stewie讲述的新闻、收件箱和Whoop健康统计数据的每日视频回顾
• 任何LLM答案，任何地方 → 适用于Claude Desktop、Claude Code或任何兼容MCP的客户端

为了学习，它涵盖了 每一个重要细节 --姓名、日期、数字、关键要点——没有什么会被跳过。幽默只是让它坚持下去。

运作原理

You ask a question → Claude answers → generate_short_video is called
                                            │
                                            ├── 1. Script: Claude writes a Peter/Stewie dialogue
                                            ├── 2. Audio: ElevenLabs generates voice for each line
                                            └── 3. Video: FFmpeg assembles the final MP4
                                                    ├── Random gameplay background
                                                    ├── Character PNGs with emotion overlays
                                                    └── Timed captions synced to audio

输出： 一个30-90秒的肖像MP4，完成后会自动打开。

快速设置

先决条件

1.克隆并安装

git clone https://github.com/matedort/short-video-mcp.git
cd short-video-mcp
pip install -r requirements.txt

2.配置API密钥

cp .env.example .env
# Edit .env with your API keys and ElevenLabs voice IDs

你的 .env 应该看起来像：

ANTHROPIC_API_KEY=sk-ant-api03-your-key-here
ELEVENLABS_API_KEY=sk_your-elevenlabs-key-here
PETER_VOICE_ID=your-peter-voice-id
STEWIE_VOICE_ID=your-stewie-voice-id

查找语音ID： 首选 elevenlabs.io/语音库，找到您喜欢的语音，将其添加到您的帐户中，然后从语音设置中复制语音ID。任何两种声音都可以——为彼得选择一种低沉的声音，为斯特维选择一种高音的声音。

3.添加资产

将文件放在：

assets/
├── background/          ← .mp4 gameplay videos (at least one)
│   ├── subwaysurfers.mp4
│   ├── minecraft.mp4
│   └── ...
└── characters/          ← Character PNGs
    ├── peter.png        ← Required
    ├── stewie.png       ← Required
    ├── peter_excited.png    ← Optional emotion variants
    ├── peter_confused.png
    ├── peter_teaching.png
    ├── stewie_angry.png
    └── stewie_excited.png

背景视频应该是 纵向 （否则，它们将被裁剪以适应）。角色PNG应该具有 透明背景.

4.联系克劳德

克劳德桌面版 --添加到 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "short-video": {
      "command": "python3",
      "args": ["/full/path/to/short-video-mcp/server.py"],
      "env": {}
    }
  }
}

克劳德代码 --添加到 ~/.claude.json 在...之下 mcpServers:

{
  "mcpServers": {
    "short-video": {
      "command": "python3",
      "args": ["/full/path/to/short-video-mcp/server.py"],
      "env": {}
    }
  }
}

然后重启克劳德。

使用示例

基本-任何问题：

“解释量子计算并制作一段关于它的短视频”

PDF学习：

*\[上传PDF文件\]* “总结并制作一个短视频——包括每个关键细节”

PowerPoint幻灯片：

*\[上传PPT\]* “为每张幻灯片生成一个短视频，这样我就可以滚动浏览了”

电子邮件追赶（使用Gmail MCP）：

“阅读我的收件箱，并生成一段短视频，总结我未读的电子邮件”

早间简报（包括预定任务）：

“每天早上8点，阅读我的收件箱，查看我的Whoop统计数据，并制作一个简短的视频简报”

克劳德代码输出：

*\[克劳德更改代码后\]* “制作一段短视频，解释你刚刚更改的内容”

主提示（一键设置）

将此提示复制并粘贴到 克劳德代码 或 克劳德桌面版 要自动设置所有内容：

I want to set up the short-video MCP server from GitHub.

Before you start, I need to confirm:
1. Do you have an Anthropic API key? (get one at console.anthropic.com)
2. Do you have an ElevenLabs API key? (get one at elevenlabs.io — free tier works)

Once confirmed, please:
1. Clone https://github.com/matedort/short-video-mcp.git to my home directory
2. Run: pip install -r requirements.txt
3. Create the .env file from .env.example and ask me for my API keys and voice IDs
4. Ask me to provide background gameplay videos (.mp4) and character PNGs, or help me find/download some
5. Add the short-video MCP server to my Claude config:
   - Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
   - Claude Code: ~/.claude.json
   Use the full path to server.py with python3 as the command
6. Tell me to restart Claude, then test it with: "Explain why pizza is the best food and generate a short video about it"

项目结构

short-video-mcp/
├── server.py            ← MCP server (the only code file)
├── requirements.txt     ← Python dependencies
├── .env.example         ← Template for API keys
├── .env                 ← Your actual API keys (git-ignored)
├── assets/
│   ├── background/      ← Gameplay videos (.mp4)
│   └── characters/      ← Character PNGs with transparent backgrounds
├── output/              ← Generated videos land here (git-ignored)
└── docs/
    └── example_screenshot.png

视频是如何构建的

1. 脚本生成 -Claude（通过Anthropic API）在Peter和Stewie之间写了一段对话，涵盖了你的内容中的所有关键信息，保持了幽默的性格。为了学习，每一个事实都被包括在内——没有什么被跳过。
2. 语音合成 --每条对话线都会被发送到ElevenLabs TTS，并带有相应的语音ID，然后所有片段都会被连接起来。
3. 视频组装 --FFmpeg合成了所有内容：

- 背景游戏视频（随机选择，循环播放） - 角色PNG位于左下角（Stewie）和右下角（Peter） - 角色根据说话的人出现/消失，并带有特定情感的图像 - 字幕文本呈现为叠加，居中并与音频定时同步

配置

故障排除

致谢

内置：

• API人类克劳德 --脚本生成
• 十一实验室 --语音合成
• FFmpeg --视频组装
• 模型上下文协议（MCP） --克劳德整合

许可证

麻省理工学院