MCP 服务器

Audacity MCP Server

Audacity 的 MCP 服务器

An-3

开发者工具

README

Audacity MCP 服务器

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

功能

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]

安装和设置

克隆或下载项目：

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

为了使 MCP 服务器与 Audacity 连接，必须启用其 mod‑script‑pipe 接口。

步骤 1：在 Audacity 中启用 mod‑script‑pipe

打开 Audacity。
打开首选项：
在 macOS 上：单击 Audacity > 首选项…
在 Windows 上：单击编辑 > 首选项…
导航到脚本/远程控制部分：
查找诸如启用 mod‑script‑pipe 或启用远程控制/脚本之类的选项。
启用该功能。
重新启动 Audacity。

步骤 2：验证命名管道

Audacity 应该创建两个命名管道（默认情况下在 macOS/Linux 上）：
命令管道：/tmp/audacity_script_pipe.to.%number%
响应管道：/tmp/audacity_script_pipe.from.%number%
在终端中运行以下命令进行验证：
```
ls -l /tmp | grep audacity_script_pipe
```

如果您看到额外的数字或字符（例如 /tmp/audacity_script_pipe.to.1234），请相应地更新 audacity_mcp_pipe.py 中的管道路径。

用法

从命令行运行 MCP 服务器 1. 导航到您的项目目录：
```
cd /%path_to_project%/mcp-audacity
```

2. 激活虚拟环境（如果尚未激活）：

source .venv/bin/activate

3. 使用 uv 工具启动服务器：

uv run audacity_mcp_pipe.py

您应该看到如下日志消息：

2025-04-13 19:36:32,759 - AudacityMCPServer - INFO - Audacity MCP 服务器正在启动
2025-04-13 19:36:32,760 - AudacityMCPServer - INFO - 打开 Audacity mod-script-pipe
2025-04-13 19:36:32,762 - AudacityMCPServer - INFO - 连接到 Audacity mod-script-pipe

MCP 端点

您的 MCP 服务器公开了几个可以由 MCP 客户端调用的端点。例如：
get_status：检索 Audacity 状态。
start_recording：开始录制。
stop_recording：停止录制。
play：开始播放。
pause：暂停播放。
这些端点在 audacity_mcp_pipe.py 中定义，可以使用 MCP 客户端触发。

与 Claude Desktop 客户端配置

如果您想通过 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"
      ]
      }
  }
}