Reaper MCP AI Analyzing

REAPER MCP AI分析

英语 | 中文

英语

REAPER DAW的模型上下文协议（MCP）服务器 AI驱动的音频分析通过自然语言控制REAPER，并从具有音频功能的AI模型中获得智能混音建议。

🚀 特性

• 25+MCP工具 用于REAPER控制（曲目、FX、路由、媒体项目）
• AI音频分析 -使用任何支持音频的AI模型分析混音
• VST3插件识别 -与VST3优先级匹配的智能插件（支持700+个插件）
• 基于文件的IPC -无需网络，适用于macOS/Windows/Linux
• 多提供商支持 -OpenAI、Google Gemini、Anthropic Claude和任何与OpenAI兼容的API

🤖 支持的AI模型

📁 项目结构

reaper-mcp-ai-analyzing/
├── src/
│   ├── index.ts              # MCP Server main entry
│   ├── types/
│   │   └── reaper.ts         # Type definitions
│   ├── utils/
│   │   ├── env.ts            # Environment config
│   │   ├── logger.ts         # Logging utility
│   │   └── audio.ts          # Audio processing
│   ├── bridge/
│   │   └── file-client.ts    # File IPC client
│   └── ai/
│       ├── analyzer.ts       # Audio analysis coordinator
│       └── providers/
│           ├── base.ts       # Base AI provider
│           └── openai.ts     # OpenAI implementation
├── bridge/
│   └── file-bridge.lua       # REAPER Lua bridge script
└── package.json

🔧 安装

# Clone the repository
git clone https://github.com/YangJue213-spec/reaper-mcp-ai-analyzing.git
cd reaper-mcp-ai-analyzing

# Install dependencies
npm install

# Build the project
npm run build

# Configure environment
cp .env.example .env
# Edit .env with your OpenAI API key

⚙️ 配置（.env）

# ============================================
# AI Provider Configuration
# ============================================

# Provider Type: 'openai', 'gemini', 'anthropic', or 'custom'
AI_PROVIDER=openai

# --- OpenAI Configuration ---
OPENAI_API_KEY=sk-your-openai-key-here
OPENAI_BASE_URL=https://api.openai.com/v1
AUDIO_MODEL_NAME=gpt-4o-audio-preview
# Alternative models: gpt-4o-mini-audio-preview

# --- Google Gemini Configuration ---
# GEMINI_API_KEY=your-gemini-key-here
# GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
# AUDIO_MODEL_NAME=gemini-2.5-pro
# Alternative models: gemini-2.5-flash

# --- Anthropic Claude Configuration ---
# ANTHROPIC_API_KEY=your-anthropic-key-here
# ANTHROPIC_BASE_URL=https://api.anthropic.com
# AUDIO_MODEL_NAME=claude-4-opus-20250514
# Alternative models: claude-4-sonnet-20250514

# ============================================
# REAPER Configuration
# ============================================
REAPER_SCRIPT_TIMEOUT=30000

🎮 MCP工具

项目和跟踪控制

• get_project_info -获取项目采样率、节奏、曲目数量
• get_track_info -获取跟踪详细信息（交易量、盘数、外汇计数等）
• create_track -使用可选名称创建新曲目
• delete_track -按索引删除曲目
• set_track_name -重命名曲目
• set_track_volume -设置音量（dB）
• set_track_pan -平底锅（-1比1）
• set_track_send -创建发送到另一个曲目
• set_track_output -路线轨迹输出

外汇管制

• get_track_fx -列出曲目中的所有外汇
• get_available_plugins -从REAPER缓存（VST3/VST/AU）中搜索可用插件
• add_fx_to_track -添加具有自动VST3优先级和单声道/立体声检测的插件
• remove_fx_from_track -按索引删除FX
• get_fx_params -获取FX的所有参数
• set_fx_param -按绝对值设置参数
• set_fx_param_normalized -设置参数（0-1归一化）
• set_fx_enabled -启用/禁用FX

媒体项目

• get_item_info -获取项目位置、长度、渐变
• split_item -在位置拆分项目

人工智能分析（核心功能）

• analyze_and_suggest_mix -使用AI渲染和分析音频
• start_audio_analysis -启动异步分析任务
• get_analysis_status -检查分析进度

🔌 MCP配置

添加到您的MCP客户端设置（Claude Desktop、Cline等）：

{
  "mcpServers": {
    "reaper-ai": {
      "command": "node",
      "args": ["/path/to/reaper-mcp-ai-analyzing/build/index.js"],
      "env": {
        "OPENAI_API_KEY": "your_api_key_here",
        "OPENAI_BASE_URL": "https://api.openai.com/v1",
        "AUDIO_MODEL_NAME": "gpt-4o-audio-preview"
      }
    }
  }
}

🎵 如何使用

1.设置后桥

1. 打开后盖
2. 首选 行动 → 显示操作列表
3. 点击 新操作 → 加载ReaScript
4. 选择 bridge/file-bridge.lua
5. 网桥现在正在运行（检查REAPER控制台上的“REAPER MCP网桥已启动”）

2.启动MCP服务器

npm start

3.使用自然语言提示

示例1：分析轨迹

"Analyze the lead vocal track (track 0) and suggest EQ improvements"

示例2：检查混音音量

"Check the overall mix loudness and tell me if it meets streaming standards"

示例3：添加FX并分析

"Add a compressor to the bass track, then analyze if the dynamics are better"

📝 示例提示

1. "Get project info and list all tracks"
2. "Set track 0 volume to -6 dB and pan to 0.2"
3. "Add Pro-Q 3 to track 1 and analyze the frequency balance"
4. "Check REAPER connection status"
5. "Analyze the master mix from 0 to 30 seconds"

______________________________________________________________________

中文

带有 AI 音频分析功能 的 REAPER MCP 服务器。通过自然语言控制 REAPER，并从任何支持音频输入的 AI 模型获取智能混音建议。

🚀 功能特性

• 25+ MCP 工具 用于 REAPER 控制
• AI 音频分析 - 使用任何支持音频的 AI 模型分析混音
• VST3 插件识别 - 智能插件匹配，优先使用 VST3（支持 700+ 插件）
• 文件 IPC - 无需网络，支持 macOS/Windows/Linux
• 多提供商支持 -OpenAI、谷歌双子座、人类克劳德

🤖 支持的 AI 模型

🔧 安装

git clone https://github.com/YangJue213-spec/reaper-mcp-ai-analyzing.git
cd reaper-mcp-ai-analyzing
npm install
npm run build
cp .env.example .env
# 编辑 .env 配置你的 AI 提供商

⚙️ 配置 (.env)

# ============================================
# AI 提供商配置
# ============================================

# 提供商类型: 'openai', 'gemini', 'anthropic', 或 'custom'
AI_PROVIDER=openai

# --- OpenAI 配置 ---
OPENAI_API_KEY=sk-your-openai-key-here
OPENAI_BASE_URL=https://api.openai.com/v1
AUDIO_MODEL_NAME=gpt-4o-audio-preview
# 备选模型: gpt-4o-mini-audio-preview

# --- Google Gemini 配置 ---
# GEMINI_API_KEY=your-gemini-key-here
# GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
# AUDIO_MODEL_NAME=gemini-2.5-pro
# 备选模型: gemini-2.5-flash

# --- Anthropic Claude 配置 ---
# ANTHROPIC_API_KEY=your-anthropic-key-here
# ANTHROPIC_BASE_URL=https://api.anthropic.com
# AUDIO_MODEL_NAME=claude-4-opus-20250514
# 备选模型: claude-4-sonnet-20250514

# ============================================
# REAPER 配置
# ============================================
REAPER_SCRIPT_TIMEOUT=30000

🔌 MCP 配置

添加到 Claude Desktop、Cline 等 MCP 客户端：

{
  "mcpServers": {
    "reaper-ai": {
      "command": "node",
      "args": ["/path/to/reaper-mcp-ai-analyzing/build/index.js"],
      "env": {
        "AI_PROVIDER": "openai",
        "OPENAI_API_KEY": "your_api_key_here",
        "AUDIO_MODEL_NAME": "gpt-4o-audio-preview"
      }
    }
  }
}

🎮 MCP 工具

工程与轨道控制

• get_project_info - 获取工程采样率、速度、轨道数量
• get_track_info - 获取轨道详情（音量、声像、效果器数量等）
• create_track - 创建新轨道（可选命名）
• delete_track - 按索引删除轨道
• set_track_name - 重命名轨道
• set_track_volume - 设置音量（dB）
• set_track_pan - 设置声像（-1 到 1）
• set_track_send - 创建发送到其他轨道
• set_track_output - 设置轨道输出路由

效果器控制

• get_track_fx - 列出轨道上的所有效果器
• get_available_plugins - 从 REAPER 缓存搜索可用插件（VST3/VST/AU）
• add_fx_to_track - 添加插件，自动优先使用 VST3 并检测单声道/立体声
• remove_fx_from_track - 按索引移除效果器
• get_fx_params - 获取效果器的所有参数
• set_fx_param - 使用绝对值设置参数
• set_fx_param_normalized - 使用归一化值（0-1）设置参数
• set_fx_enabled - 启用/禁用效果器

媒体项目

• get_item_info - 获取项目位置、长度、淡入淡出
• split_item - 在指定位置分割项目

AI 分析（核心功能）

• analyze_and_suggest_mix - 渲染并使用 AI 分析音频
• start_audio_analysis - 启动异步分析任务
• get_analysis_status - 检查分析进度

🎵 使用方法

1. 设置 REAPER 桥接

1. 打开 REAPER
2. 进入 动作 → 显示动作列表
3. 点击 新建动作 → 加载 ReaScript
4. 选择 bridge/file-bridge.lua
5. 桥接已启动（在 REAPER 控制台查看）

2. 启动 MCP 服务器

npm start

3. 使用自然语言

示例 1：分析轨道

"分析主唱轨道（轨道 0）并建议 EQ 调整"

示例 2：检查响度

"检查整体混音响度，是否符合流媒体标准"

📝 提示词示例

1. "获取工程信息并列出所有轨道"
2. "将轨道 0 音量设为 -6 dB，声像设为 0.2"
3. "给轨道 1 添加 Pro-Q 3 并分析频响平衡"
4. "检查 REAPER 连接状态"
5. "分析主混音从 0 到 30 秒的部分"

🛠️ 故障排除

“REAPER文件桥不可用”

• 确保 Lua 脚本已在 REAPER 中运行
• 检查 REAPER 控制台是否有错误信息
• 确认 /tmp/reaper-mcp 目录可访问

“AI分析器未初始化”

• 检查 .env 文件中的 OPENAI_API_KEY
• 确保已运行 npm run build

📜 许可证

MIT许可证-请参阅 许可证 文件