Audacity MCP Server

Audacity MCP 服务

用于通过 mod-script-pipe 控制 Audacity 的 MCP（Model Context Protocol）服务。

此服务通过命名管道与 Audacity 通信，并将许多 Audacity 脚本命令作为 MCP 工具提供。

功能

• 通过 mod-script-pipe 连接 Audacity
• 将大量 Audacity 命令作为 MCP 工具提供
• 使用 stdio 传输方式（适用于 Codex/Claude/桌面客户端）
• 自动检测 /tmp 中的管道后缀（例如 .501）

要求

• Audacity 3.x+
• Python 3.10+
• 在 Audacity 中启用 mod-script-pipe

安装

git clone https://github.com/An-3/mcp-audacity.git
cd mcp-audacity
./scripts/setup.sh

本地快速测试（无需 MCP 主机）

# 1) Start Audacity and enable mod-script-pipe (see section below)
# 2) Verify local connectivity:
./scripts/smoke_test.sh

# 3) Start MCP server:
./scripts/run.sh

如果你更喜欢手动设置，而不是使用脚本：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install "mcp[cli]>=1.6.0" "httpx>=0.28.1"

可选（安装为软件包并添加 CLI 入口点）：

pip install .
audacity_mcp_server

在 Audacity 中启用 mod-script-pipe

1. 打开 Audacity。
2. 打开 Modules 首选项页面：
   • Windows/Linux：Edit -> Preferences -> Modules
   • macOS：Audacity -> Settings... -> Modules（或 Audacity -> Preferences -> Modules，具体取决于构建版本）
3. 将 mod-script-pipe 从 New（或 Disabled）设为 Enabled。
4. 重启 Audacity。

注意：在当前版本的 Audacity 中，此设置位于 Modules 中，而非单独的“脚本/远程控制”部分。

确认管道存在：

ls -l /tmp/audacity_script_pipe.to.* /tmp/audacity_script_pipe.from.*

如果文件存在，Audacity 即已就绪。

手动运行服务

./scripts/run.sh

预期的启动日志包括：

• Audacity MCP server starting up
• Opened Audacity mod-script-pipe
• Connected to Audacity mod-script-pipe

从 Codex 连接

将服务添加到 Codex MCP 配置：

codex mcp add AudacityMCP -- /absolute/path/to/mcp-audacity/.venv/bin/python /absolute/path/to/mcp-audacity/audacity_mcp_server.py

列出已配置的 MCP 服务：

codex mcp list

从 Claude Desktop 连接

claude_desktop_config.json 示例：

{
  "mcpServers": {
    "audacity": {
      "command": "/absolute/path/to/mcp-audacity/.venv/bin/python",
      "args": [
        "/absolute/path/to/mcp-audacity/audacity_mcp_server.py"
      ]
    }
  }
}

故障排除

• Failed to open Audacity pipes：
  • 确认 Audacity 正在运行。
  • 确认 mod-script-pipe 已设为 Enabled。
  • 确认 /tmp 中存在管道文件。
• spawn uv ENOENT：
  • 在客户端配置中使用绝对路径，或使用上文所示的 Python 命令，而不是 uv。
• 服务已启动，但工具运行不稳定：
  • 确保使用的是此项目的最新版本，该版本以 Command: 格式发送命令，并读取完整响应，直至出现 BatchCommand finished。

许可证

MIT