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 相同的用户身份运行。
• 可选的 ffmpeg/ffprobe，用于测量 LUFS、LRA、真峰值，处理其他文件格式和元数据。测量原生 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. 使用下方的代码片段将本地服务添加到客户端，然后按需重启客户端。确保只有一个服务控制共享管道。

客户端

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

效果处理可能需要十分钟；请为客户端工具设置更长的超时时间。请参阅 客户端设置，了解官方参考资料和 Windows 命令解析方式。故障排除介绍了管道缺失和本地化插件 ID 的相关问题。

第一个提示词

检查 Audacity 的状态，如果已停止则启动它。将我的语音录音导入为 Voice。测量音频，然后展示不含归一化或降噪的干声清理方案预览。应用前先询问我，并先保存项目备份。

管线预览接受命名音轨引用或从零开始的音轨索引：

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

试试可复现的旁白示例：生成音频、经审核的清理、自动闪避的背景音轨、章节/字幕以及经测量的成品。其可选运行器通过 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 信任以你的用户身份运行的本地进程。请使用一个控制器。服务绝不会下载运行时或模型，也不会终止 Audacity。

原生安全限制 · 效果要求 · 测试 · 架构 · 贡献 · 安全

采用 MIT 许可证。研究和来源归属信息见 NOTICE.md。 Audacity 是 Muse Group 的商标；本项目与其无关。