使用说明

项目简介

Reaper MCP Server 旨在桥接 Reaper 数字音频工作站 (DAW) 与支持 Model Context Protocol (MCP) 的大型语言模型 (LLM) 客户端，例如 Claude Desktop。通过此服务器，用户可以直接在 LLM 客户端中提问关于 Reaper 项目的问题，例如项目结构、音轨信息、效果器配置等，从而实现更智能化的音乐制作工作流程。

主要功能点

查找 Reaper 项目 (find_reaper_projects): 在您指定的目录中自动搜索并列出所有的 Reaper 项目文件 (.rpp)。
解析 Reaper 项目 (parse_reaper_project): 解析选定的 Reaper 项目文件，提取项目中的音轨、效果器链、 tempo 等详细信息，并将这些信息以 JSON 格式提供给 LLM 客户端，以便 LLM 理解和分析项目内容。

安装步骤

安装依赖 打开终端，导航到仓库根目录，执行以下命令创建并激活虚拟环境，然后安装项目依赖：

uv venv
source .venv/bin/activate
uv pip install .

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 Reaper MCP Server，您需要配置客户端的服务器设置。以下是一个 Claude Desktop 客户端的配置示例，请根据您的实际情况进行调整：

{
  "servers": [
    {
      "server_name": "Reaper MCP Server",
      "command": "uv",
      "args": [
        "run",
        "python",
        "src/reaper_mcp_server/server.py",
        "--reaper-projects-dir",
        "/path/to/your/reaper/projects"  // 请替换为您的 Reaper 项目文件所在的根目录
      ],
      "transport": "stdio",
      "enabled": true
    }
  ]
}

配置参数说明:

'"server_name"': 服务器名称，您可以自定义，用于在客户端中识别。
'"command"': 启动服务器的命令，这里使用 'uv run' 来运行 Python 脚本。
'"args"': 传递给启动命令的参数列表：
- '"python src/reaper_mcp_server/server.py"': 指定执行 'server.py' 文件来启动 Reaper MCP Server。
- '"--reaper-projects-dir"': 指定 Reaper 项目根目录的参数。
- '"/path/to/your/reaper/projects"': 请务必替换为您的 Reaper 项目文件实际存放的根目录。 服务器将在这个目录下搜索 '.rpp' 文件。
'"transport"': 通信协议，这里使用 'stdio' (标准输入输出)。
'"enabled"': 设置为 'true' 以启用此服务器配置。

Claude Desktop 配置位置: 请参考仓库 README.md 中提供的 Claude Desktop 配置说明找到 Claude Desktop 的配置文件位置，并将上述 JSON 配置添加到 'servers' 数组中。

基本使用方法

启动服务器: 配置 Claude Desktop 后，启动 Claude Desktop 客户端，Reaper MCP Server 将会在后台自动启动 (如果配置正确)。
连接验证: 在 Claude Desktop 的聊天窗口底部，点击锤子图标 (工具图标)，确认您能看到 "find_reaper_projects" 和 "parse_reaper_project" 这两个 Reaper 工具。
提问关于 Reaper 项目的问题: 在 Claude Desktop 中，您可以开始提问关于您的 Reaper 项目的问题。 务必在问题中明确提及您想查询的 Reaper 项目名称。例如：“在 ‘MySong.rpp’ 项目中，Intro 音轨使用了哪些效果器？”。
查看工具调用详情: 您可以展开 Claude Desktop 工具栏中的工具，查看工具的输入参数和返回的原始项目数据，以便更好地理解 LLM 如何获取项目信息。

现在，您可以使用 Claude Desktop 与您的 Reaper 项目进行交互了！

关键词