Reaper Dev MCP

收割者开发MCP服务器

  ](https://nodejs.org/) 

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

目的

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

特性

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

安装

快速开始

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

• 克劳德代码CLI -推荐的最简单设置
• 光标IDE -适用于stdio或HTTP
• 克劳德桌面版 -需要HTTP服务器

克劳德代码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

1. 添加此配置：

{
  "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

1. 打开光标设置并添加：

{
  "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

1. 配置Claude桌面：

找到您的配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 添加此配置：

{
  "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项目

许可证

麻省理工学院