JianYing

Python MCP License

一个基于 Model Context Protocol (MCP) 的剪映视频制作自动化工具，让 AI 助手能够通过自然语言创建专业的视频内容。

🎯 项目简介

jianying mcp是一个强大的视频制作自动化工具，通过mcp协议让AI能够：

• 🎬 自动创建剪映草稿项目
• 🎵 智能添加音频、视频、文本素材
• ✨ 应用各种特效、滤镜、动画
• 🎨 自动化视频编辑流程
• 📤 导出为剪映可编辑的项目文件

🚀 核心功能

📋 草稿管理

• rules - 制作视频规范
• create_draft - 创建新的视频草稿项目
• export_draft - 导出为剪映项目文件

🛤️ 轨道管理

• create_track - 创建视频/音频/文本轨道

🎥 视频处理

• add_video_segment - 添加视频片段(可以是本地文件，也可以是url)
• add_video_animation - 添加入场/出场动画
• add_video_transition - 添加转场效果
• add_video_filter - 应用滤镜效果
• add_video_mask - 添加蒙版效果
• add_video_background_filling - 背景填充
• add_video_keyframe - 关键帧动画

🎵 音频处理

• add_audio_segment - 添加音频片段(可以是本地文件，也可以是url)
• add_audio_effect - 音频特效（电音、混响等）
• add_audio_fade - 淡入淡出效果
• add_audio_keyframe - 音频关键帧

📝 文本处理

• add_text_segment - 添加文本片段
• add_text_animation - 文字动画效果
• add_text_bubble - 文字气泡效果
• add_text_effect - 文字花字特效

🔧 实用工具

• parse_media_info - 解析媒体文件信息
• find_effects_by_type - 查找可用特效资源

📦 快速开始

1. 安装 uv

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 克隆项目并安装依赖

git clone https://github.com/your-username/jianying-mcp.git
cd jianying-mcp
uv sync

3. 配置 MCP 客户端

以 Augment Code 为例，在 MCP 客户端中添加服务器配置：

{
  "mcpServers": {
    "jianying-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/your-path/jianying-mcp/jianyingdraft",
        "run",
        "server.py"
      ],
      "env": {
        "SAVE_PATH": "/your-path/draft",
        "OUTPUT_PATH": "/your-path/output"
      }
    }
  }
}

• SAVE_PATH:数据存储路径 - 存储草稿的操作数据
• OUTPUT_PATH:导出路径 - 生成的剪映草稿文件存放位置

🎥 演示视频

🎬 点击观看完整演示视频

🔧 开发指南

调试模式

使用 MCP Inspector 进行调试：

uv run mcp dev jianyingdraft/server.py

🙏 致谢

• Model Context Protocol - 提供了强大的 AI 集成协议
• pyJianYingDraft - 剪映项目文件处理库

---

⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！