AI导哈

Audacity控制协议服务器

Audacity MCP服务器通过mod-script-pipe提供对Audacity的控制功能，适用于音频处理和自动化脚本场景。

  • by An-3
  • Python
  • 本地部署
  • 29 星标
  • 更新于
在 GitHub 查看 An-3/mcp-audacity

使用说明

Audacity MCP服务器

MCP（模型上下文协议）服务器，用于通过以下方式控制Audacity mod-script-pipe.

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

特性

  • 通过以下方式连接到Audacity mod-script-pipe
  • 将一组广泛的Audacity命令作为MCP工具公开
  • 用途 stdio 传输（与Codex/Claude/Desktop客户端配合使用）
  • 自动检测管道后缀 /tmp （例如 .501)

需求

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

安装

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脚本管道

  1. 打开Audacity。
  2. 打开 模块 首选项页面：
    • Windows/Linux: Edit -> Preferences -> Modules
    • macOS: Audacity -> Settings... -> Modules （或 Audacity -> Preferences -> Modules 取决于构建）
  3. 集 mod-script-pipe 从 New （或 Disabled)to Enabled.
  4. 重新启动Audacity。

注意：在当前的Audacity版本中，这是在 模块，而不是单独的“脚本/远程控制”部分。

验证管道是否存在：

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_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.

许可证

麻省理工学院

相关 MCP