freebeat MCP
freebeat 是最大的音乐视频生成器,它的 MCP 服务器让 AI Agent 可以直接使用它:任何歌曲都能生成音乐视频、歌词视频和舞蹈视频,还支持写歌、照片唱歌、对口型、图片和视频片段。
- 服务器地址:
https://freebeat.ai/api/mcp(远程,Streamable HTTP) - 登录: 使用你的 freebeat 账号通过 OAuth 登录,无需 API 密钥。
- 适用于: ChatGPT、Codex、Claude、Claude Code、Cursor,以及任何通过 OAuth 连接远程 MCP 服务器的 Agent。
连接
ChatGPT
- Settings → Apps → Advanced settings → 打开 Developer mode。
- Plugins → Browse directory → Add → Add custom MCP server。名称填
freebeat,URL 填https://freebeat.ai/api/mcp,认证方式选 OAuth,然后点击 Connect。 - 登录 freebeat 并点击 Allow。
Codex(CLI、IDE 扩展和应用)
codex mcp add freebeat --url https://freebeat.ai/api/mcp
codex mcp login freebeatClaude(网页版和桌面版)
- Customize → Connectors → Add → Add custom connector。
- 名称填
freebeat,URL 填https://freebeat.ai/api/mcp,然后点击 Add 和 Connect。 - 登录 freebeat 并点击 Allow。
Claude Code
claude mcp add --transport http freebeat https://freebeat.ai/api/mcp然后在 Claude Code 中运行 /mcp,选择 freebeat 并登录。
Cursor
将 freebeat 添加到 Cursor,或者把下面的内容放进 ~/.cursor/mcp.json,再在 Cursor 的 MCP 设置中点击 Connect:
{
"mcpServers": {
"freebeat": { "url": "https://freebeat.ai/api/mcp" }
}
}其他 Agent
添加一个远程 MCP 服务器,URL 为 https://freebeat.ai/api/mcp。服务器公开了它的 OAuth 元数据(/.well-known/oauth-protected-resource/api/mcp 和 /.well-known/oauth-authorization-server),并支持带 PKCE 的动态客户端注册,因此任何遵循 MCP 授权规范的客户端都可以登录。
积分
生成视频和其他内容会消耗你的 freebeat 积分;新账号赠送 500 积分。你的 Agent 在花费前会先问你:每个付费工具都需要 max_credits(你允许它花费的上限),无法提前报出总价时则需要 accept_unknown_cost。音乐视频、歌词视频和舞蹈视频按阶段分步计费,总价无法提前得知,因此需要 accept_unknown_cost。get_credit_balance 显示你的余额,quote_generation 为可报价的工具给出价格。
工具
音乐视频、歌词视频和舞蹈视频
| 工具 | 功能 |
|---|---|
generate_music_video | 按歌曲节奏剪辑的多场景音乐视频。可选上传照片(最多 5 张),让你的艺人或角色出镜。720p 或 1080p。 |
generate_lyric_video | 与人声同步的动态歌词,768p 或 2K。 |
generate_dance_video | 照片里的人随歌曲起舞(9:16 或 3:4,720p)。 |
get_video_session | 正在生成的视频的导演消息、阶段和媒体。 |
send_video_agent_message | 把你的意见发给导演,或把会话切换为自动。 |
三个视频工具都需要一首歌(来自 upload_audio 或 generate_music 的 music_id),还可以附带提示词和照片,以及 auto_mode:true 让导演全权决定,false 则让它在每个阶段暂停,等你给意见(共创)。默认使用歌曲的前 15 秒;想用其他片段,请设置 start_ms 和 end_ms,上限取决于你的账号。一个视频通常需要 15 到 60 分钟,在 freebeat 的服务器上运行;结果包含视频链接及其在 freebeat.ai 上的页面。
音乐
| 工具 | 功能 |
|---|---|
list_music_models | 你可以使用的音乐模型。 |
generate_music | 根据提示词生成原创歌曲,如果你提供歌词就用你的歌词。 |
唱歌和对口型
| 工具 | 功能 |
|---|---|
generate_singing_video | 让一张照片、一只宠物或两个人(二重唱)唱一首曲目。 |
generate_lip_sync_video | 让现有的视频片段与音频对口型。 |
图片、视频片段和文本
| 工具 | 功能 |
|---|---|
list_models, get_model_help | 可用的图片和视频模型,以及各自的用法。 |
generate_image, edit_image | 创建或编辑图片。 |
generate_video | 不带歌曲的视频片段(文生视频或图生视频)。 |
generate_text | 来自语言模型的文本。 |
list_effects, generate_effect | 用一首歌和一张图片生成特效模板视频。 |
输入、进度和积分
| 工具 | 功能 |
|---|---|
upload_audio | 来自附件文件、HTTPS 音频链接,或 SoundCloud、YouTube、Suno、Udio、TikTok、Stable Audio、Riffusion 页面的歌曲。返回 music_id。 |
upload_image, upload_video | 参考图片和视频片段。 |
get_task_status, get_task_result | 任务的进度和最终结果。 |
get_credit_balance, quote_generation | 你的余额和一次生成的价格。 |
断开连接
在你的 Agent 的连接器或 MCP 设置中移除 freebeat。断开连接会撤销该连接对你账号的访问权限。