审音 MCP 服务器

此项目实现了一个通过 mod‑script‑pipe 接口连接到 Audacity 的 MCP（模型上下文协议）服务器。使用命名管道，服务器向 Audacity 发送命令并接收响应，使您能够通过 MCP 终端控制Audacity（例如启动/停止录音或播放）。服务器可以使用 uv 工具运行，并与 Claude Desktop 客户端集成。

目录

1. 功能
2. 要求
3. 安装和设置
4. 配置 Audacity
5. 使用方法
6. 与 Claude Desktop 客户端配置
7. 故障排除
8. 许可证

功能

• Audacity 集成: 使用 mod‑script‑pipe 接口通过命名管道与 Audacity 通信。
• MCP 终端: 提供以下 MCP 工具终端：
  • 获取 Audacity 状态。
  • 启动和停止录音。
  • 播放和暂停播放。
• uv 集成: 使用 uv 工具运行 MCP 服务器。
• Claude Desktop 兼容性: 可以配置为使用 Claude Desktop 客户端启动。

要求

• Audacity 版本: 推荐版本 3.x 或更高。
• Python 版本: 3.13 或更高。
• uv 工具: 用于运行 MCP 服务器。
• mod‑script‑pipe: 必须启用 Audacity 的远程控制/脚本接口。
• Python 依赖项: 此项目需要以下包：
  • httpx
  • mcp[cli]

安装和设置

1. 克隆或下载项目:

   git clone <repository-url>
   cd mcp-audacity
   

2. 设置虚拟环境:

• 使用 uv 工具创建并激活虚拟环境：

  uv venv --python=python3.13
  source .venv/bin/activate
  

3. 安装依赖项

• 安装所需的依赖项：

  uv add "mcp[cli]" httpx
  

4. 验证项目结构
   确保项目文件夹包含至少：

• audacity_mcp_pipe.py（主 MCP 服务器脚本）
• pyproject.toml（项目配置）
• （可选）claude_desktop_config.json（如果需要与 Claude Desktop 集成）

配置 Audacity

• 如果您想通过 Claude Desktop 客户端运行您的服务器，更新您的 claude_desktop_config.json 指向此项目。例如：

  {
    "mcpServers": {
        "audacity": {
        "command": "/%absolute_path_to_ev%/.local/bin/uv",
        "args": [
            "--directory",
            "/Users/andriiboboshko/mcp-audacity",
            "run",
            "audacity_mcp_pipe.py"
        ]
        }
    }
  }
  

• 确保路径与您的项目位置匹配，并且您的虚拟环境设置正确。

使用方法

错误: spawn uv ENOENT

• 我发现当 MCP 服务器尝试启动 uv 尽管 uv 在我的 PATH 中但未能创建进程时，会发生此错误。当我将绝对路径添加到 Claude Desktop 配置 claude_desktop_config.json 时，问题得以解决。

ERROR - Failed to connect to Audacity: [Errno 61] Connection refused

• 我收到此错误是因为 Audacity 在 /tmp 文件夹中使用一些数字创建命令和响应管道文件：

  /tmp/audacity_script_pipe.to.501
  /tmp/audacity_script_pipe.from.501
  

• 在代码中更新为特定数字后，问题得以解决。

许可证

此项目根据 MIT 许可证提供。随时修改和分发即可。