Magic Master — Audio Mastering

Magic Master MCP——面向 AI Agent 的音频母带处理

远程 MCP 服务，让 Claude、ChatGPT、Cursor、VS Code、Claude Code、OpenAI Codex 及任何其他 MCP 客户端都能处理音频母带：达到响度（LUFS）目标并进行真峰值限制，移除 Suno / Udio AI 指纹，通过 24 秒预览比较预设，并以一致的相对响度处理整张专辑。处理结果会在聊天中返回测量数据和母带护照。

• 服务：https://magicmaster.pro/mcp（可流式传输的 HTTP；协议修订版本 2026-07-28、2025-11-25、2025-06-18）
• OAuth 端点（适用于无法发送标头的客户端，例如 Claude Desktop 自定义连接器）：https://magicmaster.pro/mcp/oauth
• Agent 操作手册：https://magicmaster.pro/agents.md · 机器可读清单：https://magicmaster.pro/agent.json · OpenAPI（公开子集）：https://magicmaster.pro/openapi-public.json
• 面向用户的页面（RU/EN）：https://magicmaster.pro/mcp
• 服务版本：3.15.0（由 get_service_info 报告）

无需安装：服务托管在远程端。本仓库包含连接配置示例，以及一个供无法使用 HTTP 的客户端使用的小型 stdio 桥接程序。

工具

该服务提供 11 个工具。以下描述根据实时的 tools/list 内容精简而成；实时文本为准。

工具	功能	费用
get_service_info	介绍 Magic Master 的功能、免费内容、哪些操作需要令牌，以及规则所在位置。在会话开始时调用一次。	免费
list_presets	列出全部 24 种母带处理预设及其 LUFS 目标响度。提供 master_track 和 batch_master 接受的准确键名。	免费
get_pricing	实时令牌套餐和付款方式（RUB）。价格实时读取，不依赖记忆报价。	免费
check_limits	令牌余额、剩余免费额度及重置时间、上传上限，以及 PRO 模块是否可用。	免费
analyze_track	分析综合 LUFS、采样峰值、时长、采样率和立体声相关性，不进行处理。母带处理后，get_job 会返回真峰值和响度范围。	免费
clean_ai_trace	去除 Suno / Udio AI 生成器指纹；响度和音色保持不变。返回任务 ID。	免费
preview_styles	一次使用 2–6 种预设处理音轨中间的 24 秒片段，并返回每种预设的响度和试听链接。	免费，每天 6 次
master_track	处理一首音轨的母带。账户有余额时费用为 1 个令牌；否则使用免费额度运行，不启用 PRO 模块。返回任务 ID。传入 dry_run=true 可先查看价格和生效设置。	1 个令牌
batch_master	在一次调用中使用相同设置处理最多 10 首音轨的母带。album_mode（默认为 true）会保留各音轨之间的相对响度。每首音轨返回一个任务 ID。	每首音轨 1 个令牌
get_job	查询母带处理、清理或预览任务的状态、进度和结果指标（after_lufs、true_peak_db、lra、platform_ready）。母带处理完成后会附带签名的 download_url。	免费
create_topup_link	为用户生成令牌充值结账链接。Agent 无法自行完成付款。	免费

典型流程：analyze_track →（AI 生成的音轨可使用 clean_ai_trace）→ 可选的 preview_styles → master_track → 轮询 get_job。

端点和身份验证

端点	身份验证	适用场景
https://magicmaster.pro/mcp	无，或 X-API-Key: mm_…	你编写代码、使用带有请求头的 Claude Code / Cursor / VS Code / Codex，或只需要免费工具
https://magicmaster.pro/mcp/oauth	OAuth 2.1（授权码 + PKCE S256，范围 mastering）	客户端无法发送自定义请求头（Claude Desktop、ChatGPT 连接器）

• 不使用任何密钥，也可以通过 /mcp 使用免费工具。
• 在 /mcp 上，Authorization: Bearer 表示 OAuth 访问令牌。发送到此处的账户 JWT 会返回 401，并导致免费调用也无法使用。请在 /mcp 上使用 X-API-Key，或通过 /mcp/oauth 连接。
• /mcp/oauth 收到未经身份验证的请求时，会返回 401 和 WWW-Authenticate 挑战，指向 https://magicmaster.pro/.well-known/oauth-protected-resource，因此符合规范的客户端会自行启动登录流程。
• OAuth 元数据：/.well-known/oauth-authorization-server；动态客户端注册：/oauth/register。访问令牌有效期为一小时；刷新令牌每次使用后都会轮换。令牌仅针对资源 https://magicmaster.pro/mcp 签发。
• API 密钥（mm_…）可在购买令牌后从个人资料中获取；最多可有 10 个有效密钥。

安装

Claude Code

claude mcp add --transport http magicmaster https://magicmaster.pro/mcp

免费工具可以立即使用。若要使用付费工具，请添加你的密钥：

claude mcp add --transport http magicmaster https://magicmaster.pro/mcp --header "X-API-Key: mm_YOUR_KEY"

Claude Desktop 和 claude.ai（自定义连接器，OAuth）

设置 → 连接器 → 添加自定义连接器 → URL https://magicmaster.pro/mcp/oauth → 在授权页面登录。若只需要免费工具，请使用 https://magicmaster.pro/mcp。

通过 stdio 桥接使用 Claude Desktop（如果你更喜欢配置文件）

{
  "mcpServers": {
    "magicmaster": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://magicmaster.pro/mcp/oauth"]
    }
  }
}

Cursor（.cursor/mcp.json）

{ "mcpServers": { "magicmaster": { "url": "https://magicmaster.pro/mcp" } } }

VS Code（.vscode/mcp.json）

{ "servers": { "magicmaster": { "type": "http", "url": "https://magicmaster.pro/mcp" } } }

OpenAI Codex（~/.codex/config.toml）

[mcp_servers.magicmaster]
url = "https://magicmaster.pro/mcp"

ChatGPT（开发者模式 → 连接器 → 创建）： URL https://magicmaster.pro/mcp/oauth，身份验证方式为 OAuth。

仅支持 stdio 的客户端 — npm 包封装了同一个桥接程序：

{ "mcpServers": { "magicmaster": { "command": "npx", "args": ["-y", "magicmaster-mcp"] } } }

默认情况下，桥接程序指向 https://magicmaster.pro/mcp/oauth。设置 MAGICMASTER_MCP_URL=https://magicmaster.pro/mcp，即可改用匿名端点。

一键按钮：添加到 Cursor · VS Code：vscode:mcp/install?{"name":"magicmaster","type":"http","url":"https://magicmaster.pro/mcp"}

Docker

适用于没有 Node 的客户端，以及运行安全检查的 Glama 构建：

docker build -t magicmaster-mcp .
docker run -i --rm magicmaster-mcp

镜像中仅包含桥接程序；服务本身仍托管在 https://magicmaster.pro/mcp。镜像由此代码库构建（npm ci），因此已预装 mcp-remote，容器运行时只需能够通过 HTTPS 向 magicmaster.pro 发起出站连接。镜像默认使用匿名端点。若要使用 OAuth（这也会解锁付费工具），请通过 -e MAGICMASTER_MCP_URL=https://magicmaster.pro/mcp/oauth 运行。

Glama 发布版的构建规范（平台会在其自身配置构建配方，不会读取此 Dockerfile）：

• 构建步骤：npm ci --omit=dev
• 启动命令：node bin/magicmaster-mcp.js
• 环境变量：MAGICMASTER_MCP_URL=https://magicmaster.pro/mcp

免费版与令牌

• 免费使用，无需账号： analyze_track、clean_ai_trace、preview_styles（每天 6 次）、get_job、get_pricing、list_presets、get_service_info、check_limits、create_topup_link。
• 访客母带处理（无需账号）： 每个 IP 每个自然月可处理 3 首基础母带。基础版不包含 PRO 模块。
• 免费账号： 每个 UTC 日可处理 1 首母带（注册后的前 24 小时内可处理 3 首）。同样为基础版。
• Agent 试用： 注册一次 Agent（POST /api/agents/register，使用账号的 JWT 作为 Authorization: Bearer）即可获得 3 次完整 PRO 母带处理和一个 API 密钥。MCP 连接器不会提供试用资格；只有该调用可以。参见 agents.md。
• 令牌： 1 个令牌 = 1 次完整 PRO 母带处理（任意预设、所有 PRO 模块、任意导出格式）。令牌永不过期。没有订阅服务。部分套餐包含赠送令牌。实时套餐和价格：get_pricing（RUB）或 GET https://magicmaster.pro/api/tokens/packages。
• 付款需要由真人完成。 Agent 无法完成银行卡付款。调用 create_topup_link，将结账链接交给用户，然后轮询 check_limits，直到余额到账。俄罗斯境外发行的银行卡可能会被拒绝；参见 https://magicmaster.pro/wallet。
• master_track 和 batch_master 支持 dry_run=true，可报告价格和生效设置，且不会花费任何令牌。

格式、限制与保留期限

• 输入（来自 agent.json）：aac、aif、aiff、amr、flac、m4a、mp3、ogg、wav、webm。根据内容检测格式。
• 输出： wav、wav24、mp3、flac、opus、aac。MP3 比特率为 128/192/256/320；Opus 为 128/192。
• 上传上限： 网站和 API 的未付款上限为 160 MB；购买令牌后最高可达 1000 MB（WAV）。通过此 MCP 服务，master_track 和 batch_master 每个文件最多接受 100 MB，batch_master 每次调用最多接受 300 MB（10 首曲目）。check_limits 会返回生效的单通道上限（max_upload_mb_via_mcp）。
• 音频来源： 公开的 https URL（audio_url）。Suno/Udio 歌曲页面、Google Drive 和 Dropbox 的分享链接会解析为文件。
• 已完成母带的保留期限： 访客结果仅短暂保留（存于内存中）；免费账号保留 1 天；购买令牌后保留 30 天。get_job 会返回一个有效约 1 小时的签名 download_url，无需凭据即可使用。
• 典型耗时： 每首母带处理需 20–60 秒；带修复的长曲目最多需 10 分钟。轮询 get_job，或在 master_track 中传入 webhook_url，以通过 POST 接收结果。

母带处理选项

• 预设（list_presets 提供 24 种）：例如 standard（−14 LUFS）、edm（−9）、pop（−12）、hiphop（−13）、podcast（−16）、unlimiter（−12）、voice（−16）、audiobook（−19）。使用 preview_styles 可免费试听其中两到六种预设在 24 秒音频上的效果。
• 目标响度： target_lufs 会覆盖预设，例如 Spotify 的目标值为 -14。真峰值限制遵循 ITU-R BS.1770-5。
• 输出： out_format、bitrate、dither_type（用于 16 位 WAV 的 tpdf、ns_e、ns_itu）。
• 密度： intensity 范围为 0.5（更柔和）到 1.5（更饱满）；1.0 表示按预设设计的效果。
• 修复： restore_dynamics 会在母带处理前扩展砖墙式限制的音源（适用于 unlimiter 预设）。denoise_strength（0–1）设置降噪强度；0 表示关闭。网页修复页面还列出了去除嗡声和咔嗒声的步骤，但 MCP 工具不会以名称公开这些功能。
• Suno / Udio 清理： 在 master_track 和 batch_master 中设置 remove_watermark=true，也会免费移除 AI 指纹。独立工具为 clean_ai_trace。
• 专辑模式： batch_master 的 album_mode（默认值为 true）：最响的曲目达到目标响度，其他曲目保持相对响度差异，因此安静的间奏不会被提升到与其他曲目同一响度。对于互不相关的单曲，请使用 album_mode=false。

MCP 中不包含的内容

这些功能可在网站上（或通过 API）使用，但不是 MCP 工具：

• 分轨母带处理（将 2–8 条分轨合并并作为一首曲目进行母带处理）：API POST /api/v2/master/stems，1 个令牌。
• 网页端免费人声移除和分轨：https://magicmaster.pro/stems-separation（免费；免费账户可获取 4 条分轨）。
• 调性变更器，−6…+6 个半音，免费：https://magicmaster.pro/tools/key-changer。
• 音频剪辑器，免费：https://magicmaster.pro/tools/audio-cutter。
• 削波检查（免费）和去削波器：https://magicmaster.pro/declipper。
• 发布就绪检查：https://magicmaster.pro/release-ready。尚未上线：目前开放申请，不收取费用。
• 与现场工程师混音：https://magicmaster.pro/mixing-engineer。尚未上线：目前开放申请，不收取费用。

链接

条款 https://magicmaster.pro/terms · 隐私 https://magicmaster.pro/privacy · 定价 https://magicmaster.pro/pricing · 开发者 API https://magicmaster.pro/developers · 支持 [email protected]

---

更新日志

0.3.2

• 工具列表记录了当前的 11 个工具：新增 preview_styles（免费比较，每天 6 次）和 batch_master（专辑模式，每次调用最多处理 10 首曲目）；这两项在 0.3.0 README 中遗漏。
• README：新增 Codex、带 API 密钥请求头的 Claude Code，以及 OAuth 详情（/mcp/oauth、PKCE、scope mastering）；限制和格式取自当前清单。
• Bridge（bin/magicmaster-mcp.js）在已安装打包的 mcp-remote 依赖项时使用该依赖项；仅在未安装时回退到 npx。
• 软件包元数据：扩展了描述和关键词。

---

俄语版

面向 AI Agent 以及 Claude、ChatGPT、Cursor、VS Code、Claude Code 和 Codex 等客户端的 Magic Master 远程 MCP 服务。它可将曲目调整到目标响度（LUFS）并限制 True Peak、去除 Suno/Udio 的数字痕迹、比较 24 秒片段上的预设，并在保留相对响度的情况下为整张专辑进行母带处理。无需安装任何内容——地址为 https://magicmaster.pro/mcp。

• **免费：**分析、去除 AI 痕迹、比较预设（每天 6 次）、任务状态、价格和限额。
• **付费：**1 个令牌 = 1 次完整的 PRO 母带处理。令牌不会过期，无订阅。当前价格请使用 get_pricing 工具查询（以卢布计价）。付款由用户通过 create_topup_link 提供的链接完成。
• **连接：**Claude Code — claude mcp add --transport http magicmaster https://magicmaster.pro/mcp；Claude Desktop 和 claude.ai — 使用 https://magicmaster.pro/mcp/oauth 上的自定义连接器。
• 俄语详情和连接说明：https://magicmaster.pro/mcp。支持：[email protected]。