Record Safer Pro MCP Server

Record Safer Pro 的 AI 接口服务，基于 Model Context Protocol (MCP) 标准。让 Claude、Kiro、Cursor 等 AI 助手直接控制你的专业多通道录音软件。

由 DADAO 大道声学（北京大道创响科技有限公司） 开发。

安装步骤

1. 安装 Node.js

如果你的电脑还没有 Node.js，先去 nodejs.org 下载安装（选 LTS 版本即可，需要 >= 18）。

安装完成后打开终端验证：

node -v
npx -v

两个命令都能输出版本号就说明安装成功。

2. 在 AI 客户端中添加配置

根据你使用的 AI 客户端，将以下配置添加到对应的配置文件中：

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "record-safer-pro": {
      "command": "npx",
      "args": ["-y", "record-safer-mcp-server"]
    }
  }
}

Kiro

编辑项目目录下的 .kiro/settings/mcp.json：

{
  "mcpServers": {
    "record-safer-pro": {
      "command": "npx",
      "args": ["-y", "record-safer-mcp-server"]
    }
  }
}

Cursor

在 Settings → MCP 中添加，或编辑 .cursor/mcp.json：

{
  "mcpServers": {
    "record-safer-pro": {
      "command": "npx",
      "args": ["-y", "record-safer-mcp-server"]
    }
  }
}

3. 启动 Record Safer Pro

确保 Record Safer Pro 桌面应用正在运行，然后重启你的 AI 客户端即可。

MCP Server 会自动发现后端连接地址，无需手动配置端口。每次启动时会自动获取最新版本，无需手动更新。

功能一览

当前版本采用最小权限配置，AI 助手仅开放与通道批量编辑相关的能力：

| 类别 | 能力 | |------|------| | 📊 状态查询 | 查询录音状态、通道列表、混音快照 | | 🔍 参数查询 | 查询可用录音设备、设备支持的采样率/通道范围/初始化参数 | | ⚙️ 会话准备 | 一键准备录音控制台（initialize_session，会话初始化） | | ⏺️ 录音控制 | 立即开始/停止录音，定时开始录音，定时结束录音，取消定时（所有录音动作都要求用户明确确认） | | 🎚️ 通道混音 | 批量设置音量、声像、独奏、静音、相位反转 | | 🏷️ 通道编辑 | 批量重命名通道、批量设置通道颜色 | | 🧭 工作流提示 | 内置 session_setup_workflow Prompt（引导式参数采集 / 通道单自动匹配） |

说明：其他接口（系统、存储、激活、更新、标记等）默认未开放，可按需求逐步增加。

使用示例

配置完成后，你可以直接用自然语言让 AI 操作 Record Safer Pro：

• "把 1 到 8 轨都改成更清晰的名字"
• "把鼓组相关轨道都改成红色"
• "把 1-4 轨音量调到 0.8，5-8 轨调到 0.6"
• "把 3 轨向左 20，4 轨向右 20"
• "给 6 轨开相位反转，7 轨 solo，8 轨 mute"
• "现在录音状态怎么样？"
• "现在开始录音（确认）"
• "15 分钟后开始录音，并在开始后 2 小时自动停止（确认）"

常见问题

Q: AI 提示无法连接 Record Safer Pro？ 确保 Record Safer Pro 桌面应用已启动。MCP Server 需要后端 HTTP 服务才能工作。

Q: 提示找不到 npx 命令？ 需要安装 Node.js >= 18。访问 https://nodejs.org 下载安装。

Q: 端口不是 8080 怎么办？ 正常情况下不需要手动处理，应用会自动写入端口文件。如果确实需要手动指定，设置环境变量：

{
  "mcpServers": {
    "record-safer-pro": {
      "command": "npx",
      "args": ["-y", "record-safer-mcp-server"],
      "env": {
        "RECORD_SAFER_URL": "http://127.0.0.1:你的端口号"
      }
    }
  }
}

Copyright © DADAO 大道声学（北京大道创响科技有限公司）