REAPER开发参考文档服务器

为REAPER开发提供参考文档的MCP服务器,包含ReaScript API、JSFX编程和ReaWrap API的完整函数参考和核心概念文档。

  • by Conceptual-Machines
  • Python
  • 混合部署
  • 16 星标
  • 更新于
在 GitHub 查看 Conceptual-Machines/reaper-dev-mcp

使用说明

收割者开发MCP服务器

MCP(模型上下文协议)服务器提供 参考文件 用于REAPER开发、ReaScript API、JSFX编程和ReaWrap API。

目的

此服务器提供静态参考文档,作为REAPER开发事实信息的查找参考。它通过避免在每次会话中重新发现常见模式和陷阱来帮助防止“代币烧钱”。

特性

  • 可查询的API文档:使用工具搜索并获取详细的功能信息
  • JSFX基础:核心概念和陷阱
  • ReaScript API:带有签名和参数的完整函数参考(跨C、EEL2、Lua、Python的2282个函数)
  • ReaWrap API:面向对象的包装器文档(14个类,736个方法)

安装

快速开始

选择您的IDE并按照说明进行操作:

克劳德代码CLI

先决条件: Node.js v18+

安装(一个命令):

claude mcp add --transport stdio --scope user reaper-dev -- npx -y reaper-dev-mcp

验证它是否正常工作:

claude mcp list

您应该看到: reaper-dev: npx -y reaper-dev-mcp - ✓ Connected

就是这样! 当Claude Code需要时,服务器将自动启动。重新启动Claude Code会话以使用工具。


光标IDE

Cursor支持stdio和HTTP传输。 建议使用Stdio (无需后台处理)。

选项A:stdio传输(推荐)

先决条件: Node.js v18+

  1. 打开光标设置:

    • macOS/Linux: ~/.cursor/mcp.json
    • 窗户: %APPDATA%\Cursor\mcp.json
  2. 添加此配置:

{
  "mcpServers": {
    "reaper-dev": {
      "command": "npx",
      "args": ["-y", "reaper-dev-mcp"]
    }
  }
}
  1. 重新启动游标

就是这样! Cursor将在需要时自动生成服务器。

选项B:HTTP/SSE传输

如果您更喜欢HTTP(或stdio不起作用),请使用以下方法:

  1. 启动服务器 在终端中(保持其运行):

    npx -y reaper-dev-mcp
    

    服务器将于启动 http://localhost:3000。对于自定义端口:

    PORT=8080 npx -y reaper-dev-mcp
    
  2. 打开光标设置并添加:

{
  "mcpServers": {
    "reaper-dev": {
      "type": "sse",
      "url": "http://localhost:3000"
    }
  }
}
  1. 重新启动游标

注: 服务器必须在Cursor启动之前运行。


克劳德桌面版

Claude Desktop需要HTTP/SSE传输。

先决条件: Node.js v18+

  1. 启动服务器 在终端中(保持其运行):

    npx -y reaper-dev-mcp
    

    服务器将于启动 http://localhost:3000。对于自定义端口:

    PORT=8080 npx -y reaper-dev-mcp
    
  2. 配置Claude桌面:

    找到您的配置文件:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 视窗: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  3. 添加此配置:

{
  "mcpServers": {
    "reaper-dev": {
      "type": "sse",
      "url": "http://localhost:3000"
    }
  }
}
  1. 重新启动克劳德桌面

注: 服务器必须在Claude Desktop启动之前运行。


开发设置

如果你想修改服务器或贡献:

git clone https://github.com/Conceptual-Machines/reaper-dev-mcp.git
cd reaper-dev-mcp
npm install
npm run build

在开发模式下运行:

npm run dev

运行测试:

npm run test

MCP工具

get_function_info

从JSFX、ReaScript或ReaWrap API获取有关函数的详细信息。

参数:

  • api (string):“jsfx”、“rescript”、“rewrap”中的一个
  • function_name (string):要查找的函数的名称
  • class_name (字符串,可选):对于ReaWrap API查询是必需的

示例:

// JSFX
{
  "api": "jsfx",
  "function_name": "sin"
}

// ReaScript
{
  "api": "reascript",
  "function_name": "TrackFX_GetParam"
}

// ReaWrap
{
  "api": "reawrap",
  "class_name": "track",
  "function_name": "add_fx_by_name"
}

search_functions

在JSFX、ReaScript或ReaWrap API中搜索函数。

参数:

  • api (string):“jsfx”、“rescript”、“rewrap”中的一个
  • query (string):搜索查询(函数名称、描述等)
  • limit (数字,可选):最大结果数(默认值:10)

示例:

{
  "api": "reawrap",
  "query": "create",
  "limit": 5
}

资源

所有文档均可作为MCP资源获取:

  • reascript://jsfx-fundamentals -JSFX核心概念
  • reascript://parameter-system -REAPER参数系统
  • reascript://parameter-modulation -参数链接(plink API)
  • reascript://fx-containers -外汇集装箱系统
  • reascript://reawrap-api -ReaWrap API参考

API覆盖范围

MCP服务器提供对以下内容的访问:

  • JSFX API:来自REAPER官方文档的110个功能
  • ReaScript API:2282个按语言(C、EEL2、Lua、Python)组织的函数
  • ReaWrap API:14个类,736个方法

成功标准

✅ 不再销毁代币:停止在每个会话中重新发现JSFX参数索引
✅ 快速解决问题:快速查找plink API、容器索引
✅ 防止倒退:记录所有错误,这样它们就不会重复出现
✅ 可重复使用的知识:可用于所有REAPER项目

许可证

麻省理工学院