1
打开 Claude Desktop 配置
启动 Claude Desktop，打开本地 MCP 服务器配置。
价格
低至7折
登录
将
Claude变成音乐视频引擎
将 freebeat 连接到 Claude、Cursor、Windsurf 和 Claude Code，直接在对话中生成音乐视频和 AI 视频特效。
Claude Desktop
2
添加 freebeat MCP 服务器
命名为 freebeat，并添加本地 MCP 服务器命令：
3
设置 FREEBEAT_API_KEY
在 freebeat 创建 API Key，添加到 MCP 环境变量，然后让 Claude 启动音乐视频任务。
命令集
auth
在本地保存和查看 freebeat API Key，也可以按单条命令传入 --api-key。
set-api-keyshow--api-key
assets
从本地文件或来源链接上传音频，并上传一到两张参考图片。
upload-audioupload-imagemusic_id
effects
列出可用视频特效，查看 effect_id、预览素材、默认音乐和画面比例。
listeffect_idpreview
mv
基于已上传歌曲、提示词、参考图片和画面比例提交或运行 AI 音乐视频生成。
submitrun--json
effect
通过 effect_id、music_id、图片 URL 和提示词生成特效模板短片。
submitruneffect_id
task
查询状态、等待完成，并从已完成任务中获取 video_url 和 cover_url。
statuswaitresult
Claude 里的完整音乐视频工作室
音乐视频生成、AI 特效、媒体上传和任务管理，都在同一个连接里完成
终端
> 为这首歌生成霓虹城市风格音乐视频
--aspect 9:16
--reference cover.png
● freebeat
正在上传音频...
正在创建音乐视频任务...
→ ./output/neon_mv.mp4
生成媒体
音乐视频生成
从一首歌、一段提示词或一个音乐链接开始，让 Agent 调用 freebeat 生成完整 MV，支持比例、参考素材、特效和异步渲染结果。
特效引擎
一句提示词生成音乐短片
让 Agent 查找合适的视频特效，自动填入音乐、参考图片和提示词，生成适合营销和社媒发布的短片。
Agent
> 查找适合产品发布预热的视频特效
● freebeat
找到 8 个匹配特效。
正在生成 3 个视频版本...
✓ 竖屏预热视频
✓ 方形社媒短片
模式
upload_audio 导入音频或来源链接
upload_image 添加一到两张参考图
list_effects 查看 effect_id 选项
generate_music_video 启动 MV 任务
generate_effect 启动特效任务
get_task_status 轮询任务状态
get_task_result 获取 video_url + cover_url
模式
选择特效，跳过复杂配置
从 effect_id、默认音乐、推荐参考图和模板说明开始。Agent 可以先比较模板，再选择最适合的生成方式。
自动化
从歌曲文件夹到视频流水线
CLI 和 MCP 使用同一套任务模型。你可以让 Claude 规划创意，也可以用终端脚本批量上传、生成、等待并保存 JSON。
终端
> 从 ./songs 批量生成 5 个音乐视频
● freebeat
正在读取文件夹...
正在提交任务...
✓ 已保存 5 个任务 ID
✓ results.json 已准备好
你的 Agent 里的完整音乐视频工作室
音频上传、参考图片、特效模板和渲染结果，都在一个 MCP 连接里完成
从创意到内容，一次对话完成
告诉 Claude 你要制作什么，它会选择合适的 freebeat MCP 工具并交付可用的音乐视频结果
音乐人发布
上传完成的歌曲，选择视觉方向，生成适合发布的竖屏或横屏视频。
社媒内容创作
把一首歌拆成多条短视频、开场 hook、视觉循环和基于模板的特效短片。
营销团队
通过歌曲、参考图和简短 brief 生成产品预热视频和 campaign 变体。
自动化脚本
使用 CLI 进行可重复批量任务、本地文件夹处理、JSON 输出和定时内容流水线。
从想法到音乐视频，一次对话完成
可以从一次生成开始，也可以深入到特效发现、参考素材、批量任务和轮询状态。Claude 会处理整个流程
几秒提交一个音乐视频任务
描述氛围、比例和音乐来源。Claude 会选择 freebeat MCP 工具并返回 task_id。
为这首歌生成 9:16 赛博朋克风格 MV
在对话中构建发布素材包
创建主 MV、方形裁切和短视频变体，同时保持统一视觉方向。
制作三个社媒版本并保存所有视频链接
比较特效并发布最佳结果
列出 freebeat 特效、生成多个版本、等待完成，并选择最强输出。
试用 4 个特效，并展示完成的视频
还有问题吗？
这里是最常见的问题
freebeat 如何连接到 AI Agent？
在兼容 MCP 的客户端里添加 freebeat MCP 服务器。命令是 npx -y freebeat-mcp，并通过 FREEBEAT_API_KEY 环境变量授权。
在哪里创建 API Key？
登录 freebeat 后打开 /music-video-generator/profile，在 API Keys 区域创建。此页面的 API Keys 入口也会指向那里。
支持哪些 Agent？
Claude Desktop、Cursor、Windsurf、Claude Code 以及其他兼容 MCP 的客户端都可以使用同一套配置。
MCP 和 CLI 有什么区别？
MCP 面向 Agent 对话调用，CLI 面向终端和脚本。两者都支持上传、特效、生成、轮询和结果读取。
为什么生成任务需要轮询？
音乐视频渲染需要时间。freebeat 会先返回 task_id，然后 Agent 或 CLI 查询状态，完成后获取 video_url。
可以创建什么内容？
可以创建音乐视频、模板特效短片、竖屏社媒视频、横屏 MV，以及使用参考图控制风格的版本。
需要把 API Key 写进提示词吗？
不需要。Key 应该保存在 MCP 环境配置或 CLI 凭据中。提示词只需要描述创作任务。
结果可以用于自动化流程吗？
可以。完成后的任务会返回结构化链接和状态字段，适合写入 JSON、表格、内容日历和脚本。
