音频 MCP 服务器文档

概述

服务器通过可流式传输的 HTTP 协议传输模型上下文协议（MCP）。请将任何 MCP 客户端指向以下端点，并使用 VocalRemover API 令牌进行身份验证。文件以公共 HTTP(S) URL 的形式提交（最大 100 MB），处理结果将以可下载的 URL 形式返回。

Endpoint:  https://vocalremover.com/mcp/audio
Transport: Streamable HTTP (POST)
Auth:      Authorization: Bearer YOUR_API_TOKEN

快速入门

1. 在 API 页面.
2. 使用下面的代码片段将服务器添加到客户端中。
3. 提问：“从 <您的文件 URL> 中去除人声。”

身份验证

1. 创建一个免费账户并打开 API 页面.
2. 生成一个 API 令牌。
3. 请将其作为 Bearer 令牌添加到您的 MCP 客户端配置中（参见下文）。

免费音频工具和付费 AI 工具均使用此代币；两者的区别仅在于是否会扣除转换分钟数积分。

客户端设置

将服务器添加到您的 AI 客户端中。Claude Desktop 使用 mcp-remote 桥接器；Cursor、Windsurf、Cline、Zed 和 Claude Code 原生支持通过 Bearer 令牌连接远程 MCP；ChatGPT 和 Claude.ai 网页应用将其作为自定义连接器添加，并通过 OAuth 登录（详见下文）。

{
  "mcpServers": {
    "vocalremover": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://vocalremover.com/mcp/audio",
        "--header", "Authorization:${AUTH}"
      ],
      "env": { "AUTH": "Bearer YOUR_API_TOKEN" }
    }
  }
}

{
  "mcpServers": {
    "vocalremover": {
      "url": "https://vocalremover.com/mcp/audio",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

claude mcp add --transport http \
  vocalremover https://vocalremover.com/mcp/audio \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Anthropic 消息 API（构建您自己的智能代理）

使用 MCP 连接器测试版标头将服务器连接到 Claude API 调用：

client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Remove vocals from https://example.com/song.mp3"}],
    mcp_servers=[{
        "type": "url",
        "url": "https://vocalremover.com/mcp/audio",
        "name": "vocalremover",
        "authorization_token": "YOUR_API_TOKEN",
    }],
    betas=["mcp-client-2025-11-20"],
)

ChatGPT（自定义连接器）

在 ChatGPT 设置中，启用开发者模式，打开“应用与连接器”→“创建”，并添加一个指向下方服务器 URL 的自定义连接器。 ChatGPT 将执行 OAuth 流程——您需登录 VocalRemover 并授权访问；无需粘贴令牌。（需使用支持自定义连接器的套餐，例如 Plus/Pro/Business/Enterprise。）

https://vocalremover.com/mcp/audio

您的套餐中没有自定义连接器访问权限？请创建一个自定义 GPT，并添加一个操作，该操作将通过 API 密钥（Bearer）身份验证导入我们的 OpenAPI 架构。

Claude（Web 应用、Cowork 及 Claude Code）

将服务器作为自定义连接器添加一次，然后允许网络访问，以便 Claude 能够上传和获取您的音频。

1. 打开“自定义”→“连接器”。
2. 点击“添加连接器”（“+”按钮），然后选择“添加自定义连接器”。
3. 将“名称”设置为“VocalRemover”，在下方粘贴 MCP 服务器 URL，然后点击“添加”。
4. 登录 VocalRemover，并在系统提示时批准访问权限——无需粘贴令牌。

https://vocalremover.com/mcp/audio

1. 打开“设置”→“功能”。
2. 启用“允许网络出站流量”。
3. 添加以下两个域名： vocalremover.com 以及 s3.vocalremover.com

就这样。开启一个新的 Chat、Cowork 或 Claude Code 会话，上传音频文件并说“去除人声”——Claude 会自动上传并返回处理结果。

Claude Pro、Max、Team 和 Enterprise 版本均支持自定义连接器。

工具

上传本地文件

工具接受公共 URL。如果文件位于用户本地，请调用免费的 create_upload 工具获取一次性上传链接，将文件通过 POST 方式上传至该链接（无需令牌），然后将返回的 file_url 传递给任何音频工具。上传链接和文件将在 1 小时后过期。 切勿将真实的音频文件进行 Base64 编码——其体积远超工具参数的限制。

Assistant calls:  create_upload { "filename": "song.mp3" }
            ->  { "upload_url": "https://vocalremover.com/api/uploads/01h...",
                  "file_url":   "https://vocalremover.com/storage/mcp-uploads/01h....mp3",
                  "upload_page":"https://vocalremover.com/upload/01h..." }

# Upload the bytes (model's sandbox, a terminal, or the user's browser):
curl -F "file=@song.mp3" "https://vocalremover.com/api/uploads/01h..."
            ->  { "file_url": "https://vocalremover.com/storage/mcp-uploads/01h....mp3" }

Assistant calls:  separate_audio { "url": "", "task": "vocals" }

无法发起 Web 请求（例如沙盒化的助手）？请向用户发送 upload_page 链接，让用户在浏览器中拖放文件，然后继续使用 file_url。

在 Claude 中，文件上传需要向 vocalremover.com 和 s3.vocalremover.com 发送出站网络流量——请在“设置”→“功能”下启用此功能（参见上文的 Claude 配置说明）。

示例：去除人声

只需用通俗易懂的语言向您的助手提出请求：

You: Remove the vocals from https://example.com/song.mp3

Assistant calls:  separate_audio { "url": "...", "task": "vocals" }
            ->  { "job_id": "01H...", "status": "in_process_queue" }

Assistant calls:  check_audio_job { "job_id": "01H..." }
            ->  { "done": true, "outputs": [
                    { "track": "vocals",        "download_url": "https://..." },
                    { "track": "instrumentals", "download_url": "https://..." }
                ] }

免费工具的工作原理也一样——例如，“将此文件转换为 wav”会调用 convert_audio 函数，并立即返回一个下载链接，且不消耗任何积分。

建议尝试的内容

• ›请从 https://example.com/song.mp3 中去除人声，并提供卡拉OK伴奏。
• ›将此音轨拆分为各声部——人声、鼓、贝斯、吉他和钢琴。
• ›将https://example.com/interview.m4a转换为128 kbps的MP3格式。
• ›仅从该视频中提取音频：https://example.com/clip.mp4
• ›请对这期播客进行降噪并去除房间回声：https://example.com/episode.wav
• ›将此音轨中歌手的嗓音转换为音色 ID“tenor-male”，并将音高提高 2 半音：https://example.com/song.mp3
• ›制作一个 8D 版本，并将其剪辑至 30 秒。
• ›https://example.com/track.flac 的时长和比特率是多少？
• ›查询我的信用余额。

限制与注意事项

• 输入文件必须是公开的 http(s) URL，每个文件大小不超过 100 MB。
• AI分离操作以异步方式运行——请务必通过轮询 check_audio_job 来获取结果。
• 积分按音频每分钟计费，仅适用于 AI 分离功能。
• 免费音频工具从不使用片尾字幕。

隐私与安全

• 您的音频将从您提供的 URL 中获取，经过处理后即被删除——我们不会存储您的文件。
• 您的 API 令牌仅限于您的账户；您可以随时在 API 页面上撤销它。
• 该端点仅支持 HTTPS；我们会屏蔽解析为私有/内部地址的 URL。

故障排除

返回 MCP 服务器概述