JinDaGe - mcp-audacity MCP Details

article

README

🚀 审音 MCP 服务器

本项目构建了一个借助 mod‑script‑pipe 接口与 Audacity 相连的 MCP（模型上下文协议）服务器。借助命名管道，服务器能向 Audacity 发送指令并接收反馈，让您可通过 MCP 终端对 Audacity 进行操控，比如开启/停止录音或播放。该服务器可利用 uv 工具运行，还能与 Claude Desktop 客户端实现集成。

🚀 快速开始

本项目实现了一个通过 mod‑script‑pipe 接口连接到 Audacity 的 MCP 服务器。借助命名管道，服务器与 Audacity 通信，实现对其的控制。同时，该服务器可使用 uv 工具运行，并与 Claude Desktop 客户端集成。

✨ 主要特性

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

📦 安装指南

克隆或下载项目

git clone <repository-url>
cd mcp-audacity

设置虚拟环境

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

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

安装依赖项

安装所需的依赖项：

uv add "mcp[cli]" httpx

验证项目结构

确保项目文件夹包含至少以下内容：

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 许可证。您可自由进行修改和分发。

mcp-audacity