内容
# helix-stadium-mcp
使用纯语言处理 Line 6 Helix Stadium 预设，无需了解技术细节。
将 AI 助手指向 `.hsp` 预设，询问其功能，两个快照之间的差异，或更改它 - 亮化主音通道，增加混响，设置节奏 / 主音 / 清洁快照。你会得到纯英文的答案，带有实际值（dB，Hz，ms）而不是原始参数数字，并且任何编辑都安全地写回。它是一个 [MCP](https://modelcontextprotocol.io) 服务器，因此它可以在任何 MCP 客户端（Claude Desktop，Cursor，VS Code 等）上运行。
## 示例
询问 *"这个预设是做什么的？"* 并指向一个 `.hsp` 文件。你会得到整个信号链的回复，按路径分:
```
# 双整流器主音
节奏 120.0 BPM | 激活快照 #0
快照：1. 节奏（蓝色），2. 主音（红色）
## 路径 1
[放大器] Cali Rectifire — 开启 [每快照] · 驱动 7.5 | 低音 5.0 | 主音 4.0
[音箱] 4x12 Cali V30 — 开启 · 高音截止 9.0 kHz | 距离 2.0 "
[效果] Minotaur — 开启 [每快照] · 增益 45 % | 级别 60 %
[效果] 简单延迟 — 开启 [每快照] · 混音 18 % | 时间 400 ms | 反馈 25 %
```
友好的模型名称，开启/关闭状态（以及哪些快照切换它），以及每个参数的单位，你可以直接从硬件上读取。
因为它理解整个补丁，所以它也可以 **为你更改它**。要求在主音通道上增加增益或添加更多混响，它会编辑确切的块和参数 - 然后通过安全检查（验证 → 字节精确往返 → 原子写入备份）写入结果。它还可以从头开始构建预设，设置快照，并组装一个列表。
## 尝试询问
- *"这个预设是做什么的？"*
- *"我的节奏和主音快照之间有什么不同？"*
- *"在放大器后添加一个 Plate 混响，并将混音设置为 20%。"*
- *"在不使声音变大情况下，为主音快照增加更多增益。"*
- *"在这个预设上设置节奏，主音和清洁快照。"*
- *"为我创建一个具有 US Deluxe 放大器，1x12 音箱和弹簧混响的清洁预设。"*
- *"为我找一个 plexi 风格的放大器。"* / *"列出所有延迟模型。"*
- *"将这些预设转换为周五演出的列表。"*
## 它能做什么
- **读取** `.hsp` 预设无损（字节精确往返）。
- **解释** 预设为纯英文 - 每个路径的完整信号链，带有友好的模型名称，开启/关闭状态，每快照和脚踏板标签，以及参数的实际单位（dB，Hz，ms，%）。
- **比较快照** - 两个快照之间（例如节奏 vs 主音）更改的确切内容，以实际单位表示。
- **编辑** - 使用纯语言更改参数的实际单位，切换或添加 / 删除 / 重新排序块，重命名和设置快照。任何模型都可以按其出厂默认值添加。
- **创建** - 从头开始新建一个预设并逐一构建。
- **组装列表** - 将一批预设排序成列表并附上演出前检查清单。
- **浏览** 模型目录（列出 / 描述 / 搜索模型）。
- **验证** 预设的结构（以及使用目录，其模型 ID 和控制器源）。
每次更改都通过安全门写入 - 验证 → 往返 → 原子写入备份 - 并且 `HELIX_MCP_READONLY` 保持服务器只读，任你所需。
## 安装和配置
```bash
uvx twelvetake-helix-stadium-mcp serve # 或：pipx run twelvetake-helix-stadium-mcp serve
```
将其添加到你的 MCP 客户端配置中。大多数使用 `mcpServers` 块:
```json
{
"mcpServers": {
"helix-stadium": {
"command": "uvx",
"args": ["twelvetake-helix-stadium-mcp", "serve"]
}
}
}
```
如果目录未自动检测，请将 `HELIX_STADIUM_RES` 设置为你的安装目录 `res/` 文件夹（包含 `P35ModelCatalog.json`）。使用 `helix-stadium-mcp doctor` 检查检测。
要保持服务器只读 - 例如，当你指向你不完全信任的预设时 - 设置 `HELIX_MCP_READONLY=1`，写入工具将在启动时被移除。
## 工具
**读取**
| 工具 | 你会问它 |
|---|---|
| `read_preset` | 加载一个 `.hsp` 文件并获取其结构（路径，块，快照） |
| `explain_preset` | 用纯英文表示完整的信号链，带有实际单位 |
| `diff_snapshots` | 两个快照之间更改的内容 |
| `list_models` · `describe_model` · `search_models` | 浏览模型目录 |
| `validate_preset` | 检查预设的结构 |
| `detect_install` | 查找 Helix Stadium 目录 |
**编辑和构建**
| 工具 | 你会问它 |
|---|---|
| `edit_param` | 设置参数，按当前值或特定快照 |
| `add_block` · `remove_block` · `move_block` | 添加，删除或重新排序块 |
| `toggle_block` | 打开/关闭块 - 全局或每个快照 |
| `configure_snapshots` · `set_active_snapshot` | 命名场景并选择活动的一个 |
| `rename_preset` · `rename_snapshot` | 重命名预设或快照 |
| `create_preset` | 从头开始新建一个预设来构建 |
| `build_setlist` | 将预设组装成列表 + 检查清单 |
每个写入工具都通过上述安全门；设置 `HELIX_MCP_READONLY` 以移除它们。
## 路线图
预-1.0，按照 [semantic versioning](https://semver.org) - 工具界面在小版本之间仍可能更改。
- **v0.1** - 读取，解释和比较预设；浏览模型目录；验证预设。
- **v0.2（当前）** - 助手为你进行更改：编辑参数，切换 / 添加 / 删除 / 重新排序块，重命名和设置快照；从头开始构建预设；组装列表 - 使用纯语言。每次写入都通过安全门，`HELIX_MCP_READONLY` 按需保持只读。
- **v0.3** - 根据描述生成整个预设。
- **v1.0** - 一个稳定的工具界面。
macOS 支持正在进行中，适用于 Windows。
## 需求
- **Helix Stadium** 已安装（Windows 已确认；macOS 支持正在进行中）。服务器在运行时从您自己的安装中读取模型目录和每个模型的定义。
- Python 3.10+。
## 商标
不隶属于或得到 Line 6 或 Yamaha Guitar Group 的认可。
所有商标均为其各自所有者的财产。“Line 6”，“Helix”和“Helix Stadium”，以及任何放大器，音箱或效果型号名称和其他品牌或产品名称（例如通过型号目录或预设），此处仅用于识别兼容设备。本项目对任何商标不享有所有权。
## 许可证
MIT © TwelveTake Studios LLC。参见 [LICENSE](https://github.com/TwelveTake-Studios/helix-stadium-mcp/blob/main/LICENSE)。
