Gizmos Audacity

Gizmos Audacity MCP

Audacity で音声を編集、処理、測定するためのローカル MCP ツールです。

45 個の型付きツール · Audacity 3.7.x · Node 24.21+ · stdio

音声のインポート、トラックやクリップの編集、エフェクトの適用、ラベルの書き込み、ミックスのエクスポート、ピーク値／RMS またはオプションの LUFS／トゥルーピークの測定ができます。処理は Audacity が行います。Windows では非表示ウィンドウとネイティブダイアログの復旧に対応しています。macOS／Linux ではスクリプティング FIFO に対応していますが、ネイティブウィンドウのライフサイクルは検証されていません。

要件

• 英語版 Audacity 3.7.x で mod-script-pipe が有効であること：3.7.8 をリファレンスビルド（同梱カタログ、パラメーター上限、ソース監査）とし、3.7.9 も検証済みです。ほかのパッチバージョンは検証されるまで拒否されます。Windows では、次のコマンドでインストールしてバージョンを固定してください。 winget install --id Audacity.Audacity -e --version 3.7.8、続けて winget pin add --id Audacity.Audacity -e --version 3.7.8。
• Audacity 4 はサポート対象外です：4.0 ではスクリプティングインターフェース（mod-script-pipe）が削除されました。完全な制御が可能なスクリプティングホストを Audacity が提供した場合に限り、サポートを再検討します。
• Node.js 24.21 以降を使用し、Audacity と同じユーザーとして実行すること。
• LUFS、LRA、トゥルーピーク、その他のファイル形式やメタデータの処理には、オプションで ffmpeg/ffprobe が必要です。ネイティブ PCM／float WAV の測定には不要です。

クイックスタート

npm パッケージは @gizmos-quest/audacity-mcp です。ソースをチェックアウトした場合は、npm ci を実行してから npm run build を実行してください。サーバーコマンドには node dist/main.js を使用します。

1. Audacity 3.7.8 をインストールします。Preferences → Modules で mod-script-pipe を有効にし、Preferences → Interface で英語を選択します。また、Preferences → Application → Check for updates をオフにします（更新通知はモーダルダイアログで、閉じるまでスクリプティングをブロックします）。Audacity を再起動します。

2. セットアップを確認します。

   npx -y @gizmos-quest/audacity-mcp doctor
   

   Audacity を停止した状態で doctor --fix を実行すると、スクリプティングモジュールを有効にできます。最初に設定ファイルのバックアップを保存します。セットアップと設定。

3. 以下のスニペットを使ってローカルサーバーをクライアントに追加し、必要に応じてクライアントを再起動します。共有パイプを制御するサーバーは 1 つだけにしてください。

クライアント

Claude Code

claude mcp add --scope user --transport stdio audacity -- npx -y @gizmos-quest/audacity-mcp

Claude Desktop / Cursor — クライアントの MCP 設定に以下を追加します。

{
  "mcpServers": {
    "audacity": {
      "command": "npx",
      "args": ["-y", "@gizmos-quest/audacity-mcp"]
    }
  }
}

VS Code — .vscode/mcp.json：

{
  "servers": {
    "audacity": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@gizmos-quest/audacity-mcp"]
    }
  }
}

Codex — ~/.codex/config.toml：

[mcp_servers.audacity]
command = "npx"
args = ["-y", "@gizmos-quest/audacity-mcp"]
startup_timeout_sec = 90
tool_timeout_sec = 900

エフェクトの処理に 10 分かかることがあります。クライアントのツールタイムアウトは長めに設定してください。公式リファレンスと Windows のコマンド解決については、クライアントのセットアップをご覧ください。トラブルシューティングでは、パイプが見つからない場合や、プラグイン ID がローカライズされている場合について説明しています。

最初のプロンプト

Audacity の状態を確認し、停止している場合は起動してください。私の音声録音を Voice としてインポートしてください。測定した後、ノーマライズやノイズリダクションを含めない、音声クリーンアップのドライラン計画を提示してください。適用する前に確認を求め、先にプロジェクトのバックアップを保存してください。

パイプラインのプレビューでは、名前またはゼロ始まりのトラック参照を指定します。

{"track":"Voice","preset":"voice","dryRun":true,"loudness":"none"}

再現可能なナレーションの例をお試しください。音声の生成、確認済みのクリーンアップ、ダッキングしたBGM、チャプター／字幕、測定済みの納品物が含まれています。オプトイン方式のランナーは、ビルド済みサーバーを stdio 経由で起動し、実際の Audacity を操作します。

ツール

グループ	ツール
セッションと検出	launch, fresh, quit, window, dialogs, recover, status, project_info, info, describe
編集とミックス	select, import, export, project, track_set, track_edit, clip_move, clip_set, edit, fade, envelope_set
処理	generate, effect, noise_profile, pipeline, auto_duck, command, menu, macros, batch
ラベル	labels_set, labels, labels_file, label_regions_export
測定と制御	measure, measure_file, compare_files, loudness_target, silence, contrast, probe_file, targets, transport, history, preferences

各名前の先頭には audacity_ が付きます。ツールリファレンスには引数と単位が記載されています。機能マトリックスには制限がまとめられています。

安全性

• 破壊的な処理を行う前に、新しい .aup3 バックアップを保存してください。スクリプトによるエフェクト処理では、個別の取り消し履歴は作成されません。既存のプロジェクトの保存先は拒否されます。
• 厳格な入力チェックと確認済みのカタログにより、既知のモーダルコマンドはブロックされます。非表示の Audacity も UI とオーディオエンジンを実行します。ネイティブのヘッドレスモードはありません。
• タイムアウトしても、編集が完了している場合と、まだ実行中の場合があります。ダイアログを確認し、明示的な復旧を行ってから、次の対応を決める前にプロジェクトを確認してください。
• ノイズリダクションには、新しい処理状態と、明示的なルームトーンの録音が必要です。ノーマライズ、リミッティング、タイミングの変更は明示的に行ってください。
• mod-script-pipe は、ユーザーと同じ権限で実行されるローカルプロセスを信頼します。コントローラーは1つだけ使用してください。サーバーがランタイムやモデルをダウンロードしたり、Audacity を強制終了したりすることはありません。

ネイティブの安全性に関する制限 · エフェクトの要件 · テスト · アーキテクチャ · コントリビューション · セキュリティ

MIT ライセンスです。調査内容とソースの帰属表示については、NOTICE.mdをご覧ください。 Audacity は Muse Group の商標です。本プロジェクトは同社とは無関係です。