内容
# RC-505mk2 助手
**描述您想要的FX机架。克劳德构建它并将其上传到您的循环站。**
一个免费的本地克劳德桌面扩展程序，适用于 [Boss RC-505mk2](https://www.boss.info/cn/products/rc-505mk2/)。 用简单的语言交流—— *"新灵魂乐队人声机架"*, *"DnB 鼓声处理"*, *"带有HPF扫描和反向混响的分解"* —— 并在您的设备上通过USB获得一个真正的内存预设。 无需深入菜单，无需手动编辑RC0文件，无需云账户。
> **测试版** —— 从 [GitHub Releases](https://github.com/hysteve/rc505mk2-mcp/releases) 下载 `.mcpb`。 通过 [Issues](https://github.com/hysteve/rc505mk2-mcp/issues) 反馈。
---
喜欢这个项目吗？用一杯咖啡支持更多的循环站黑客行为！
<a href="https://www.buymeacoffee.com/hysteve" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" ></a>
---
## 您能做什么
| 任务 | 示例提示 |
|------|----------------|
| **加载捆绑预设** | *"将人声板式机架加载到插槽5"* |
| **适应特定流派或氛围** | *"为新灵魂乐队现场人声创建FX机架"* |
| **从头开始构建** | *"分解机架：HPF扫描，反向混响增强，回声渐隐——没有捆绑预设"* |
| **浏览库** | *"您有哪些人声机架？"* · *"显示用于过渡的模块"* |
| **读取和调整硬件** | *"内存插槽3中有什么？"* · *"拉取插槽5，添加 slapback 延迟，合并后"* |
| **分享预设** | 从 `~/.rc505mk2/racks/` 等目录复制文件，或用于仅硬件用户的RC0 ZIP |
| **上传到硬件** | 连接USB存储模式 → 请求将任意机架推送到内存插槽 |
**包含：** 43种风格/样式 **机架** 预设，33个可重复使用的 **FX模块**，**26个MCP工具**，服务器端验证（TFX插槽规则，参数强制转换）。 所有内容都在您的本地机器上运行 —— MCP服务器不调用云。
不熟悉术语？从 **[docs/CONCEPTS.md](./docs/CONCEPTS.md)** 开始 —— 机架 vs 内存插槽，IFX/TFX，JSON格式，适配 vs 构建工作流程。
---
## 安装
### 克劳德桌面（推荐）
1. 从 [Releases](https://github.com/hysteve/rc505mk2-mcp/releases/latest) 下载 `rc505mk2-v{version}.mcpb`
2. 双击 → **安装** 在克劳德桌面
3. 通过USB连接RC-505mk2 → **菜单 → USB → 存储 → 连接**
4. 尝试： *"我的rc505连接了吗？"* ， *"列出捆绑的机架预设"* 或 *"将人声板式机架加载到插槽5"*
**要求：** 克劳德桌面（带有扩展）， [Boss RC-505mk2](https://www.boss.info/cn/products/rc-505mk2/)，USB电缆。 macOS测试最佳；欢迎使用Windows/Linux —— 请报告问题。
### 从源代码（MCP配置）
```bash
git clone https://github.com/hysteve/rc505mk2-mcp.git
cd rc505mk2-mcp
npm install && npm run build
npx rc505mk2 doctor
```
将您的MCP客户端指向 `dist/mcp/server.js`，或在发布后使用 `npx`:
```json
{
"mcpServers": {
"rc505mk2": {
"command": "npx",
"args": ["-y", "rc505mk2-mcp"]
}
}
}
```
**本地开发：** `"command": "node", "args": ["<repo>/dist/mcp/server.js"]`
---
## 关键概念（简要）
| 术语 | 含义 |
|------|---------|
| **FX模块** | 一个调谐效果（`人声板式`，`HPF扫描`）—— 自定义链的构建块 |
| **机架** | 一个精选的IFX + TFX信号链配方 —— **不是** 一个完整的内存插槽 |
| **内存插槽** | 设备上的预设1–99 —— 跟踪，节奏，韵律和所有FX |
| **IFX** | 输入FX —— 在录制前使用（插槽A–D） |
| **TFX** | 跟踪FX —— 在录制的循环中；银行A/B，插槽A–D每个 |
| **适配** | 从最接近的捆绑机架开始，调整，上传 |
| **构建** | 仅从FX模块组成 —— 跳过捆绑的机架预设 |
完整指南和JSON示例： **[docs/CONCEPTS.md](./docs/CONCEPTS.md)**
---
## 示例会话
```
您： 我的RC-505连接了吗？
您： 为DnB鼓处理创建FX机架并上传到插槽3
您： 从头开始构建一个自定义分解机架 —— HPF扫描，反向混响，回声渐隐
您： 读取插槽3，导出为共享JSON，然后将更紧密的延迟合并回设备
```
更多复制粘贴提示： [docs/TEST_PROMPTS.md](./docs/TEST_PROMPTS.md)
---
## 工具（26）
| 类别 | 工具 |
|----------|-------|
| 参考 | `list_fx_types`, `lookup_fx_params` |
| 浏览 | `list_fx_modules`, `get_fx_module`, `list_rack_presets`, `get_rack_preset`, `resolve_rack`, `list_memory_configs`, `get_memory_config` |
| 构建 | `build_rack_config`, `generate_memory`, `parse_memory` |
| 保存 | `create_fx_module`, `update_fx_module`, `delete_fx_module`, `create_rack_preset`, `update_rack_preset`, `delete_rack_preset`, `save_memory_config` |
| 硬件共享 | `export_zip`, `import_zip` |
| 设备 | `detect_device`, `list_device_slots`, `read_device_slot`, `upload_memory`, `eject_device` |
典型上传： `upload_memory` with `rack_id` + `slot_number`. 用户创建的预设保存在 `~/.rc505mk2/` —— 保存工具返回 `file_path` 用于共享。
完整参考： [docs/UNIFIED_MCP_TOOLS.md](./docs/UNIFIED_MCP_TOOLS.md) · 共享： [docs/SHARING.md](./docs/SHARING.md)
---
## 命令行界面
```bash
rc505mk2 generate config.json --slot 5 --output ./output
rc505mk2 detect
rc505mk2 doctor
rc505mk2 list-fx
rc505mk2 lookup-fx REVERB
```
---
## 开发
```bash
npm install
npm run build
npm test
npm run pack:mcpb # → releases/rc505mk2-v{version}.mcpb (克劳德桌面包)
```
贡献和发布： [CONTRIBUTING.md](./CONTRIBUTING.md)
包源： `mcpb/manifest.json` + `mcpb/icon.png`. 查看 [mcpb/README.md](./mcpb/README.md)。
| 文档 | 描述 |
|-----|-------------|
| [CONCEPTS.md](./docs/CONCEPTS.md) | 机架，模块，JSON格式，工作流程（从这里开始） |
| [ARCHITECTURE.md](./docs/ARCHITECTURE.md) | 技术设计 |
| [UNIFIED_MCP_TOOLS.md](./docs/UNIFIED_MCP_TOOLS.md) | 工具列表和存储布局 |
| [SHARING.md](./docs/SHARING.md) | 共享JSON和RC0 ZIP交换 |
| [TEST_PROMPTS.md](./docs/TEST_PROMPTS.md) | 按工作流程复制粘贴测试提示 |
| [LIBRARY.md](./docs/LIBRARY.md) | TypeScript库API |
MCP服务器的工作流程规则位于 `src/mcp/instructions.ts` （在初始化时返回到克劳德桌面）。
---
## 硬件和官方文档
| 资源 | 链接 |
|----------|------|
| **设备** | [BOSS RC-505mkII](https://www.boss.info/cn/products/rc-505mk2/) |
| **用户手册** | [RC-505mk2 用户手册（PDF）](https://static.roland.com/assets/media/pdf/RC-505mk2_eng02_W.pdf) |
| **参数指南** | [RC-505mk2 参数指南（PDF）](https://static.roland.com/assets/media/pdf/RC-505mk2_Parameter_eng02_W.pdf) |
此仓库中的FX参数数据来自官方参数指南。 USB存储布局遵循用户手册（`菜单 → USB → 存储 → 连接`）。
---
## 许可证
MIT —— 见 [LICENSE](./LICENSE)。 免费使用，修改和分享；保留版权声明。
不隶属于Boss，Roland Corporation或Anthropic。
