MCP Audacity

🚀 審音 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 許可證。您可自由進行修改和分發。