Audacity MCP Server

基本能力

产品定位

mcp-audacity 是一个用于控制 Audacity 音频编辑软件的 MCP 服务，通过 MCP 协议提供对 Audacity 的远程控制能力。

核心功能

• Audacity 集成：通过 mod‑script‑pipe 接口与 Audacity 通信。
• MCP 端点：提供以下功能端点：
• 获取 Audacity 状态。
• 开始/停止录音。
• 播放/暂停播放。
• uv 工具集成：使用 uv 工具运行 MCP 服务。
• Claude Desktop 兼容性：可与 Claude Desktop 客户端集成。

适用场景

• 自动化音频编辑流程。
• 远程控制 Audacity 进行录音或播放操作。
• 与其他工具或服务集成，实现音频处理的自动化。

工具列表

• uv 工具：用于运行 MCP 服务。
• mod‑script‑pipe：Audacity 的远程控制/脚本接口。

常见问题解答

• Error: spawn uv ENOENT：确保在 Claude Desktop 配置中使用 uv 的绝对路径。
• ERROR - Failed to connect to Audacity: [Errno 61] Connection refused：检查 Audacity 创建的命名管道文件路径，并在代码中更新相应的路径。

使用教程

使用依赖

1. Audacity：推荐使用 3.x 或更高版本。
2. Python：版本 3.13 或更高。
3. uv 工具：用于运行 MCP 服务。
4. mod‑script‑pipe：确保 Audacity 的远程控制/脚本接口已启用。
5. Python 依赖：
6. httpx
7. mcp[cli]

安装教程

1. 克隆或下载项目： git clone <repository-url> cd mcp-audacity
2. 设置虚拟环境： uv venv --python=python3.13 source .venv/bin/activate
3. 安装依赖： uv add "mcp[cli]" httpx
4. 验证项目结构：确保项目文件夹包含以下文件：
5. audacity_mcp_pipe.py
6. pyproject.toml
7. （可选）claude_desktop_config.json

调试方式

1. 启用 mod‑script‑pipe：
2. 打开 Audacity。
3. 进入 Preferences（偏好设置）。
4. 启用 Scripting/Remote Control 中的 mod‑script‑pipe 选项。
5. 重启 Audacity。
6. 验证命名管道： ls -l /tmp | grep audacity_script_pipe
7. 运行 MCP 服务： uv run audacity_mcp_pipe.py
8. 检查日志：确保服务成功启动并连接到 Audacity。

许可证

该项目遵循 MIT 开源许可条款。