AI导哈

AI视频编辑插件

BlenderMCP-VSE是一个Blender插件，通过AI和自然语言命令实现视频编辑、效果添加、音频管理和渲染输出。

  • by anan0110692
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 anan0110692/blender-mcp-vse

使用说明

BlenderMCP VSE-使用AI进行Blender视频编辑

Blendermcp-一切 扩展原始 搅拌机MCP 一个完整的项目 视频序列编辑器（VSE） 集成，通过Claude和模型上下文协议（MCP）实现AI驱动的视频编辑。

这个分叉将Blender转换为AI可控的视频编辑套件，允许您编辑视频、添加效果、管理音频和渲染输出，所有这些都可以通过自然语言命令完成。

这个叉子有什么新功能

视频序列编辑器（VSE）集成

这个叉子增加了 30+新工具 要获得完整的视频编辑功能：

类别 工具
带材管理 添加电影、声音、图像、图像序列、场景、颜色和文本条
条带编辑 移动、修剪、剪切、复制、删除条带
效果与过渡 交叉淡入淡出、擦除、伽玛交叉和其他过渡
音频控制 音量、平移和音频条管理
高级效果 速度控制、调节层、效果条
时间线控制 帧导航、预览范围、播放控制
组织 用于分组的元条带，多条带选择
出口 渲染设置、编解码器选择、动画渲染

特性

原始BlenderMCP功能

  • 双向通信：通过基于套接字的服务器将Claude AI连接到Blender
  • 三维对象操作：创建、修改和删除三维对象
  • 材料控制：应用和修改材质和颜色
  • 现场检查：获取当前场景的详细信息
  • 代码执行：在Blender中运行Claude的Python代码
  • 保利港湾一体化：下载HDRI、纹理和3D模型
  • Hyper3D罗丹：人工智能生成的3D模型
  • Sketchfab集成：搜索和下载3D模型
  • 浑源3D技术支持：额外的AI模型生成

VSE新功能

  • 导入媒体：添加视频、音频、图像和图像序列
  • 非线性编辑：在时间线上剪切、修剪、移动和排列剪辑
  • 过渡：在剪辑之间添加交叉渐变、擦除和其他过渡
  • 文本叠加：添加具有可自定义属性的文本条
  • 色带：创建纯色背景或覆盖
  • 音频编辑：控制音量、平移和音频定时
  • 速度效果：反向播放、慢动作、速度斜坡
  • 调整图层：在多个条带上应用效果
  • 元条带：将条带组合在一起进行组织
  • 渲染输出：配置分辨率、FPS、编解码器和导出视频

安装

先决条件

  • 搅拌机4.0+ （与Blender 5.x兼容）
  • Python 3.10+
  • uv包管理器

安装uv

macOS：

brew install uv

窗户：

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

将uv添加到PATH（Windows）：

$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

Linux：

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

第一步：安装Blender插件

  1. 下载 addon.py 来自此存储库
  2. 打开搅拌机
  3. 首选 编辑>首选项>附加组件
  4. 点击 “安装…” 并选择 addon.py 文件
  5. 通过检查启用插件 “接口：搅拌机MCP”

步骤2：配置MCP服务器

克劳德桌面版

编辑您的 claude_desktop_config.json:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["--from", "git+https://github.com/anan0110692/blender-mcp-vse", "blender-mcp"]
        }
    }
}

Claude 代码命令行工具

claude mcp add blender -- uvx --from git+https://github.com/anan0110692/blender-mcp-vse blender-mcp

光标

添加到MCP设置（设置>MCP）：

macOS/Linux：

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["--from", "git+https://github.com/anan0110692/blender-mcp-vse", "blender-mcp"]
        }
    }
}

窗户：

{
    "mcpServers": {
        "blender": {
            "command": "cmd",
            "args": ["/c", "uvx", "--from", "git+https://github.com/anan0110692/blender-mcp-vse", "blender-mcp"]
        }
    }
}

用法

启用VSE集成

  1. 在Blender中，打开 3D视图侧边栏 （按 N)
  2. 查找 “搅拌机MCP” 标签
  3. 检查 “使用视频编辑（VSE）” 启用视频编辑工具
  4. 点击 “联系克劳德”

示例命令

视频编辑

  • “从E:\Videos\clip.mp4导入视频并将其添加到时间线中”
  • “在第100帧处剪切视频”
  • “修剪剪辑开头的前2秒”
  • “在两个剪辑之间添加交叉渐变”
  • “反转视频播放”
  • “将视频设置为半速播放”

音频

  • “从频道2上的music.mp3添加背景音乐”
  • “将音量设置为50%”
  • “将原始视频音频静音”

文本和图形

  • “在开头添加一个标题，上面写着‘欢迎’”
  • “为30帧创建一个黑色条带作为介绍”
  • “为第一个剪辑添加淡入效果”

出口

  • “将输出分辨率设置为1920x1080”
  • “将帧速率设置为每秒30帧”
  • “将视频渲染为H.264 MP4”

3D+视频工作流程

  • 使用旋转立方体创建3D场景，然后将其渲染为视频条
  • “将3D渲染添加到时间线中，并在下面添加音乐”

VSE工具参考

媒体导入

工具 说明
add_movie_strip 将视频文件添加到时间线
add_sound_strip 将音频文件添加到时间线
add_image_strip 将单个图像添加为条形
add_image_sequence 将图像序列添加为条形
add_scene_strip 将Blender场景添加为条形
add_color_strip 添加纯色条带
add_text_strip 添加文本叠加条

条带编辑

工具 说明
get_strip_info 获取详细的条带信息
move_strip 将条带移动到不同的位置/通道
trim_strip 装饰条起点/终点
cut_strip 在特定框架处分割条带
duplicate_strip 创建条带副本
delete_strip 从时间线中删除条形图
set_strip_properties 修改条形图属性

效果与过渡

工具 说明
add_transition 添加条带之间的过渡
add_effect_strip 添加视觉效果
add_adjustment_layer 添加调整层
add_speed_control 控制播放速度/倒档

音频

工具 说明
set_strip_volume 调整音量
set_strip_pan 调整立体声平移

时间线

工具 说明
get_vse_info 获取时间线概述
set_frame_current 跳转到特定帧
set_frame_range 设置开始/结束帧
set_preview_range 设置预览范围
get_strips_at_frame 在框架处找到条带

组织

工具 说明
make_meta_strip 将条带组合在一起
unmake_meta_strip 取消分组元条带
select_strips 选择特定条带
select_all_strips 选择所有条带

渲染

工具 说明
set_render_settings 配置输出设置
render_animation 渲染视频输出

配置

环境变量

变量 默认值 描述
BLENDER_HOST localhost Blender套接字服务器主机
BLENDER_PORT 9876 Blender套接字服务器端口
DISABLE_TELEMETRY false 禁用匿名遥测

禁用遥测

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["--from", "git+https://github.com/anan0110692/blender-mcp-vse", "blender-mcp"],
            "env": {
                "DISABLE_TELEMETRY": "true"
            }
        }
    }
}

兼容性

  • 搅拌机4.x：全力支持
  • 搅拌机5.x：完全支持（包含API兼容层）
  • 操作系统：Windows、macOS、Linux

故障排除

问题 解决方案
VSE工具未出现 在BlenderMCP面板中启用“使用视频编辑（VSE）”
连接失败 确保Blender插件正在运行并已连接
找不到条带 用检查条带名称 get_vse_info
渲染失败 验证输出路径是否可写
音频未播放 检查音频条是否已静音

贡献

欢迎投稿！请随时提交问题和拉取请求。

学分

许可证

MIT许可证-请参阅 许可证 了解详情。

免责声明

这是一个社区项目，与Blender基金会或Anthropic没有正式联系。

相关 MCP