Skip to Content
MCP Documentation

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

  1. Settings → Apps → Advanced settings → 打开 Developer mode。
  2. Plugins → Browse directory → Add → Add custom MCP server。名称填 freebeat,URL 填 https://freebeat.ai/api/mcp,认证方式选 OAuth,然后点击 Connect。
  3. 登录 freebeat 并点击 Allow。

Codex(CLI、IDE 扩展和应用)

codex mcp add freebeat --url https://freebeat.ai/api/mcp codex mcp login freebeat

Claude(网页版和桌面版)

  1. Customize → Connectors → Add → Add custom connector。
  2. 名称填 freebeat,URL 填 https://freebeat.ai/api/mcp,然后点击 Add 和 Connect。
  3. 登录 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。断开连接会撤销该连接对你账号的访问权限。

Last updated on