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