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