tuney

Tuney MCP 服务

Tuney 提供免版税音乐，可用于视频、广告、播客、游戏和应用。音乐由音乐人创作、演奏和录制的音乐元素组成，并可调整至所需的精确时长。本仓库是 Tuney MCP 服务的所在地：一个可供任何 MCP 客户端使用的远程服务，以及针对大家最常询问的助手和编辑器提供的安装说明。

• 服务 URL： https://api.tuney.io/cue-engine2/connector/mcp
• 传输方式： MCP streamable HTTP
• 身份验证： OAuth 2.0（使用 PKCE 的授权码流程、动态客户端注册）。你可以在浏览器中使用 Tuney 账户登录；服务绝不会获取你的密码。
• 账户： 你需要一个 Tuney 账户，可在 app.tuney.io 免费创建。搜索、生成、调整和试听预览均免费。下载最终文件会使用账户中的积分，规则与 Tuney 应用中完全相同。
• 文档： app.tuney.io/claude · 隐私声明： app.tuney.io/claude/privacy · 支持： [email protected]

服务功能

工具	功能	是否使用积分
list_styles	列出 Tuney 支持的流派、情绪和节奏	否
find_tracks	根据需求说明，或按流派、情绪和节奏查找现成曲目，并即时试听	否
generate_track	使用 Tuney 手工制作的音乐元素创作新曲，并调整至精确时长（5 s 至 10 min）	否
get_task / wait_for_task	跟踪生成或下载任务，直到完成	否
get_track	显示曲目信息：名称、预览链接、时长、bpm、调性、风格和段落	否
adjust_track	重新渲染曲目，可调整时长、转折点、淡出或短结尾、节奏或调性，也可静音或重新生成分轨	否
download_track	提供最终文件的下载链接，格式可选 mp3、wav 或分轨（旋律、和弦、贝斯、鼓、效果）	是
get_account	显示已连接的 Tuney 账户及其积分余额	否
import_video	通过公开链接导入视频文件	否
get_video_upload_link	提供一次性链接，用于发送本地视频文件（curl -T），文件大小最多为 100 MB	否
analyze_video	显示画面剪辑点、人物说话的位置，并猜测声音标识	否
score_video	根据视频的剪辑点创作音乐，在声音标识前结束，并渲染配乐后的视频	否
render_video	为视频添加你的一首曲目，并在人们说话时降低音量	否

你不需要亲自调用这些工具。只需向助手提出需求，例如：

• “帮我找一段温暖的原声音乐，用作 45 秒旅行视频博客的片头。”
• “为产品视频生成一段轻快的 30 秒流行音乐。”
• “把时长改成 60 秒，在 30 秒处设置转折点，并加上一个短结尾。”
• “旁白部分去掉鼓声。”
• “下载为分轨。”
• “为这则广告配乐：轻快的流行音乐，在标志出现前结束。”（附上视频链接或文件）

结果中的文件链接（预览、下载和渲染后的视频）位于 api.tuney.io，有效期为六小时。如果你的助手运行在网络访问受限的沙盒中，请允许访问 api.tuney.io。

从客户端连接

Claude（claude.ai、Claude Desktop、Claude mobile）

依次前往 Settings → Connectors → Add custom connector，粘贴服务 URL，然后点击 Connect 并使用 Tuney 账户登录。Tuney 列入 Claude 连接器目录后，你也可以直接从目录中一键添加。

Claude Code

安装 Tuney 插件，其中包含该服务以及一项指导 Claude 如何更好地使用它的技能：

claude plugin marketplace add library-x/tuney_claude_plugin
claude plugin install tuney@tuney

或者只添加服务：

claude mcp add --transport http tuney https://api.tuney.io/cue-engine2/connector/mcp

然后在 Claude Code 中运行 /mcp，并在打开的浏览器窗口中登录。插件源代码：library-x/tuney_claude_plugin。

ChatGPT

ChatGPT 通过开发者模式连接 MCP 服务：

1. 前往 Settings → Connectors → Advanced → 开启 Developer mode。
2. 返回 Connectors，选择 Create，将名称设为 Tuney，粘贴服务 URL，将 Authentication 设为 OAuth，然后创建。
3. 按提示使用 Tuney 账户登录。
4. 在聊天中打开工具菜单（“+”或 More），并启用 Tuney。

付费 ChatGPT 套餐支持开发者模式。在 Team、Enterprise 和 Edu 套餐中，管理员可能需要先启用此功能。

Cursor

点击安装：

或者将其添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "tuney": {
      "url": "https://api.tuney.io/cue-engine2/connector/mcp"
    }
  }
}

Cursor 会检测到该服务使用 OAuth，并在 Settings → MCP 中于其旁显示 Sign in 操作。

VS Code（GitHub Copilot）

从命令行添加：

code --add-mcp '{"name":"tuney","type":"http","url":"https://api.tuney.io/cue-engine2/connector/mcp"}'

或者将以下内容放入工作区中的 .vscode/mcp.json（或用户配置文件的 mcp.json）：

{
  "servers": {
    "tuney": {
      "type": "http",
      "url": "https://api.tuney.io/cue-engine2/connector/mcp"
    }
  }
}

从 MCP 视图或 MCP: List Servers 命令启动服务；VS Code 首次启动时会打开 Tuney 登录页面。

Codex CLI

codex mcp add tuney --url https://api.tuney.io/cue-engine2/connector/mcp
codex mcp login tuney

codex mcp list 会显示该服务以及你的登录状态。也可以在 ~/.codex/config.toml 中手动写入相同配置：

[mcp_servers.tuney]
url = "https://api.tuney.io/cue-engine2/connector/mcp"

Gemini CLI

gemini mcp add --transport http tuney https://api.tuney.io/cue-engine2/connector/mcp

然后，在 Gemini CLI 中运行 /mcp auth tuney 登录。~/.gemini/settings.json 中对应的配置如下：

{
  "mcpServers": {
    "tuney": {
      "httpUrl": "https://api.tuney.io/cue-engine2/connector/mcp",
      "oauth": { "enabled": true }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "tuney": {
      "serverUrl": "https://api.tuney.io/cue-engine2/connector/mcp"
    }
  }
}

其他 MCP 客户端

使用支持流式 HTTP 传输的服务 URL。该服务遵循 MCP 授权规范，因此支持 OAuth 2.0 动态客户端注册的客户端无需其他配置。实现者可在以下位置查找发现信息：

• 受保护资源元数据：https://api.tuney.io/cue-engine2/connector/.well-known/oauth-protected-resource
• 授权服务器元数据：https://api.tuney.io/cue-engine2/connector/.well-known/oauth-authorization-server
• 面向从主机根目录查找的客户端，两项元数据的主机根目录副本：https://api.tuney.io/.well-known/oauth-authorization-server/cue-engine2/connector 和 https://api.tuney.io/.well-known/oauth-protected-resource/cue-engine2/connector/mcp

不支持需要预注册客户端 ID 或静态令牌的客户端；注册采用动态开放方式。

MCP Registry

该服务已发布在官方 MCP Registry，名称为 io.github.library-x/tuney；本仓库中的 server.json 是该列表的来源。

断开连接与数据

在客户端中断开连接会撤销其对 Tuney 账户的访问权限；你创建的曲目仍会保留在账户中。隐私声明说明了服务会存储哪些内容（短期会话和令牌），以及不会存储哪些内容（你的对话）。如有疑问，请联系：[email protected]。

许可证

本仓库内容采用 MIT 许可证。Tuney 的音乐采用 Tuney 条款授权。