Video Studio MCP Server
让 AI Agent(Cursor / Claude Code / Windsurf)直接调用 AI 视频/图片生成云服务 + 抖音/小红书内容下载。
功能
- 🎬 AI 视频生成 — Sora2、Grok、Veo 等模型,竖屏/横屏/多时长
- 🖼️ AI 图片生成 — GPT-Image-2、Gemini 等,自动保存到本地
- 📊 视频内容分析 — Gemini 多模态分析视频结构和文案
- ✍️ AI 文案写作 — 仿写、润色、批量变体
- 📥 视频下载 — 抖音/小红书无水印下载(双链路保障)
- 💰 积分管理 — 余额查询、生成结果自动报告
快速开始
一句话安装 — 复制下面这句话给你的 AI Agent(Cursor / Claude Code / Windsurf):
帮我安装 Video Studio MCP:https://raw.githubusercontent.com/Joshuayang228/video-studio-mcp/master/docs/install.md
Agent 会自动完成:下载代码、安装依赖、配置 MCP、注册 Skill。装完后提供账号密码即可开始使用。
一句话更新 — 已安装过?复制这句话让 Agent 更新:
帮我更新 Video Studio MCP:https://raw.githubusercontent.com/Joshuayang228/video-studio-mcp/master/docs/update.md
手动安装
1. 安装依赖
pip install -r requirements.txt
2. 配置 IDE
在你的 IDE(Cursor / Claude Code)的 MCP 配置中添加:
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"video-studio": {
"command": "python",
"args": ["/path/to/mcp-server/server.py"]
}
}
}
Claude Code (~/.claude/mcp.json):
{
"mcpServers": {
"video-studio": {
"command": "python",
"args": ["/path/to/mcp-server/server.py"]
}
}
}
3. 登录
在对话中告诉 Agent:
"帮我登录 video-studio,用户名 xxx,密码 xxx"
登录一次后 token 自动保存,后续无需重复操作。
工具列表
| 工具 | 功能 | 消耗积分 |
|---|---|---|
login |
登录云端服务 | ❌ |
whoami |
查看登录状态和余额 | ❌ |
list_models |
查询可用模型和参数 | ❌ |
check_balance |
查询积分余额 | ❌ |
video_create |
创建 AI 视频 | ✅ |
video_status |
查询视频生成进度 | ❌ |
video_download |
获取视频下载链接 | ❌ |
image_generate |
生成 AI 图片 | ✅ |
video_analyze |
分析视频内容 | ✅ |
chat |
AI 对话/文案 | ✅ |
download_video |
下载抖音/小红书视频 | ❌ |
Agent 使用指南
安装后 Agent 会自动读取 SKILL.md,了解如何:
- 先查模型参数再生成(不猜参数)
- 确认用户意图后再消耗积分
- 轮询视频进度并及时反馈
- 下载抖音/小红书内容并分析
详见 SKILL.md
下载功能
支持的平台:
- 抖音:分享链接 → 无水印视频下载(主链路 iesdouyin + yt-dlp 兜底)
- 小红书:分享链接 → 视频/图文下载(yt-dlp)
# 在对话中直接说:
"帮我下载这个抖音视频:https://v.douyin.com/xxxxx"
"下载这个小红书:https://www.xiaohongshu.com/explore/xxxxx"
项目结构
mcp-server/
├── server.py # MCP Server 主文件
├── SKILL.md # Agent 使用指南(Cursor Skills)
├── requirements.txt # Python 依赖
├── .env.example # 环境变量模板
├── .gitignore
├── output/ # 生成的图片保存目录(自动创建)
└── downloads/ # 下载的视频保存目录(自动创建)
扩展能力
如需更多互联网内容获取能力(搜 Twitter、读 Reddit、YouTube 字幕),推荐配合 Agent-Reach。
License
MIT