Magic Master — Audio Mastering

Magic Master MCP — AI エージェント向けオーディオマスタリング

Claude、ChatGPT、Cursor、VS Code、Claude Code、OpenAI Codex、その他あらゆる MCP クライアントでオーディオをマスタリングできるリモート MCP サーバーです。True Peak リミッティングでラウドネス（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
• エージェント向けプレイブック：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 の機能、無料の内容、トークンが必要な操作、ルールの掲載場所を確認します。セッションの開始時に 1 回呼び出します。	無料
list_presets	LUFS の目標ラウドネスが設定された 24 種類すべてのマスタリングプリセットを一覧表示します。master_track と batch_master で指定できる正確なキーを取得できます。	無料
get_pricing	トークンパックと支払い方法（RUB）の最新情報を取得します。価格は記憶に頼らず、最新情報を読み込みます。	無料
check_limits	トークン残高、残りの無料利用枠とリセット日時、アップロード上限、PRO モジュールが利用可能かどうかを確認します。	無料
analyze_track	処理を行わず、統合 LUFS、サンプルピーク、再生時間、サンプルレート、ステレオ相関を取得します。True Peak とラウドネスレンジは、マスタリング後に get_job から取得できます。	無料
clean_ai_trace	Suno / Udio の AI 生成フィンガープリントを除去します。ラウドネスと音質はそのまま維持されます。ジョブ ID を返します。	無料
preview_styles	中央の 24 秒を一度に 2～6 種類のプリセットでマスタリングし、それぞれのラウドネスと試聴リンクを返します。	無料、1 日 6 回
master_track	1 トラックをマスタリングします。アカウントに残高がある場合は 1 トークンかかります。そうでない場合は、PRO モジュールなしで無料利用枠を使って実行されます。ジョブ ID を返します。事前に料金と適用される設定を確認するには、dry_run=true を渡します。	1 トークン
batch_master	1 回の呼び出しで最大 10 トラックを同じ設定でマスタリングします。album_mode（既定値は true）を使うと、トラック間の相対ラウドネスが維持されます。トラックごとにジョブ ID を 1 つ返します。	トラックごとに 1 トークン
get_job	マスタリング、クリーンアップ、プレビュージョブのステータス、進捗、結果の測定値（after_lufs、true_peak_db、lra、platform_ready）を取得します。マスタリング完了時には、署名付きの download_url が含まれます。	無料
create_topup_link	人間向けのトークン購入手続きを準備します。エージェント自身が支払いを完了することはできません。	無料

一般的な流れ：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 を返し、https://magicmaster.pro/.well-known/oauth-protected-resource を指す WWW-Authenticate チャレンジを送信するため、準拠クライアントは自動的にサインインを開始します。
• OAuth メタデータ：/.well-known/oauth-authorization-server。動的クライアント登録：/oauth/register。アクセストークンの有効期間は1時間です。リフレッシュトークンは使用するたびにローテーションされます。トークンはリソース 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）

Settings → Connectors → Add custom connector → 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（Developer mode → Connectors → Create）： 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 は組み込み済みで、コンテナの実行時に必要なのは magicmaster.pro への HTTPS のアウトバウンド接続のみです。イメージはデフォルトで匿名エンドポイントを使用します。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（1日6回）、get_job、get_pricing、list_presets、get_service_info、check_limits、create_topup_link。
• ゲストのマスタリング（アカウント不要）： 1つのIPアドレスにつき、暦月あたり3回の基本マスタリングが可能です。基本マスタリングにはPROモジュールは含まれません。
• 無料アカウント： UTC日付ごとに1回マスタリングできます（登録後24時間は3回）。こちらも基本マスタリングです。
• エージェント向けトライアル： エージェントを一度登録すると（アカウントのJWTをAuthorization: Bearerとして指定してPOST /api/agents/registerを実行）、PROマスタリングを3回分とAPIキーが付与されます。MCPコネクターではトライアルは付与されず、この呼び出しのみが対象です。agents.mdを参照してください。
• トークン： 1トークンで、あらゆるプリセット、すべてのPROモジュール、あらゆるエクスポート形式を利用した完全なPROマスタリングを1回実行できます。トークンに有効期限はありません。サブスクリプションはありません。一部のパックにはボーナストークンが含まれます。販売中のパックと価格は、get_pricing（RUB）またはGET https://magicmaster.pro/api/tokens/packagesで確認できます。
• 支払いには人間の操作が必要です。 エージェントはカード決済を完了できません。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は1回あたり最大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を返します。このURLは認証情報なしで使用できます。
• 一般的な所要時間： マスタリング1回あたり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秒の音声で2～6種類を無料で比較できます。
• 目標ラウドネス： 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です。
• アルバムモード： album_mode（既定値はtrue）を指定したbatch_masterでは、最も音量の大きいトラックが目標値に達し、ほかのトラックは相対的な音量差を保ちます。そのため、静かなインタールードの音量が単曲と同じレベルまで引き上げられることはありません。関連のない単曲を処理する場合は、album_mode=falseを使用してください。

MCP に含まれない機能

これらの機能はウェブサイト（または API）で利用できますが、MCP ツールではありません。

• ステムマスタリング（2～8 個のステムをまとめて 1 つのトラックとしてマスタリング）：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（無料比較、1 日 6 回）と batch_master（アルバムモード、1 回の呼び出しにつき最大 10 トラック）を追加。どちらも 0.3.0 の README から漏れていました。
• README に Codex、API キーヘッダーを使用する Claude Code、OAuth の詳細（/mcp/oauth、PKCE、スコープ mastering）を追加。制限とフォーマットは現在のマニフェストに基づいています。
• ブリッジ（bin/magicmaster-mcp.js）は、バンドルされた mcp-remote 依存関係がインストールされている場合はそれを使用し、インストールされていない場合に限り npx にフォールバックします。
• パッケージのメタデータ：説明とキーワードを拡充しました。

---

ロシア語

AI エージェントや、Claude、ChatGPT、Cursor、VS Code、Claude Code、Codex などのクライアント向けの Magic Master リモート MCP サーバーです。トラックを目標ラウドネス（LUFS）に調整し、True Peak を制限して、Suno/Udio のデジタル痕跡を除去します。また、24 秒の抜粋でプリセットを比較し、相対的なラウドネスを保ちながらアルバム全体をマスタリングします。インストールは不要です。アドレスは https://magicmaster.pro/mcp です。

• **無料：**分析、AI の痕跡の除去、プリセットの比較（1 日 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]。