内容
# 混音思维 v5.0
**混音思维 v5.0** 是一个模型上下文协议（MCP）服务器，用于通过自然语言控制 **Behringer X-Air 18 / XR18 / X18** 混音器，可选地与 **混音站** 桌面应用程序集成。
它允许 AI 助手像现场音响技术人员一样工作：检查音板、移动推子、调整监听发送、调节 EQ、管理效果、保存快照、备份设置、检查音量计，并使用普通语言运行演出宏。
## 功能概述
| 领域 | 混音思维控制内容 |
| --- | --- |
| 设备发现 | 通过 `/xinfo` 广播在本地网络中查找 X-Air 混音器。 |
| 直接混音器控制 | 通过 UDP 端口 `10024` 的 OSC 与混音器通信。 |
| 混音站桥接 | 在启用时使用混音站 REST/WebSocket API。 |
| 通道管理 | 读取通道名称、颜色、静音、推子、左右分配、增益、门控、动态均衡、EQ 和发送。 |
| 监听混音 | 将通道发送到 1-6 号总线和 1-4 号效果发送，以人耳听觉分贝值设置。 |
| EQ 和处理 | 将 Hz、dB、Q、声像、增益和阈值等人类值转换为 X-Air 线路值。 |
| 快照和备份 | 列出、保存、加载和备份混音器状态。 |
| 现场检查 | 读取音量计并检测剪切或高信号。 |
| 演出宏 | 运行可重复的操作，如休息音乐、演出模式、静音输入、关闭效果和恢复效果。 |
| OSC 地图搜索 | 包含一个大型可搜索的 X-Air OSC 地图，用于高级或未文档化的参数。 |
## 包含的 MCP 工具
混音思维向您的 MCP 客户端公开了这些工具：
`xair_discover`、`xair_connect`、`xair_info`、`xair_map_search`、`xair_map_describe`、`xair_get`、`xair_set`、`xair_batch_set`、`xair_node_dump`、`xair_channel_overview`、`xair_fader`、`xair_mute`、`xair_mute_group`、`xair_send_level`、`xair_channel_detail`、`xair_eq_band`、`xair_headamp`、`xair_fx`、`xair_snapshot_list`、`xair_snapshot_save`、`xair_snapshot_load`、`xair_backup_dump`、`xair_meters`、`xair_macro_list`、`xair_macro_run`、`xair_macro_save`、`ms_app_state`、`ms_api` 和 `ms_value`。
## 系统要求
- Python `3.10` 或更高版本
- Behringer X-Air 混音器在同一网络上
- MCP 客户端，如 Claude Desktop
- 可选：启用 API 的混音站桌面应用程序
## 安装
克隆仓库并以可编辑模式安装：
```bash
git clone https://github.com/mlmil/Mix_Mind_v5.0.git
cd Mix_Mind_v5.0
python3 -m pip install -e .
```
## MCP 客户端配置
将此服务器添加到您的 MCP 客户端配置中。对于 macOS 上的 Claude Desktop，请编辑：
```text
~/Library/Application Support/Claude/claude_desktop_config.json
```
示例：
```json
{
"mcpServers": {
"mix-mind": {
"command": "python3",
"args": ["-m", "xair_mcp.server"],
"cwd": "/absolute/path/to/Mix_Mind_v5.0",
"env": {
"XAIR_HOST": "192.168.1.50",
"MS_API_URL": "http://127.0.0.1:8080"
}
}
}
}
```
`XAIR_HOST` 是可选的。如果您不知道混音器的 IP 地址，请让您的助手运行 `xair_discover`，然后使用 `xair_connect` 连接。
`MS_API_URL` 仅在 `ms_*` 工具中使用。在混音站桌面应用程序中，在设置中启用 API，然后使用应用程序显示的本地 URL。
## 快速入门
1. 将您的计算机和 X-Air 混音器置于同一网络中。
2. 使用 `python3 -m pip install -e .` 安装软件包。
3. 将上述 MCP 配置添加到您的客户端。
4. 重启您的 MCP 客户端。
5. 请求：`查找我的 X-Air 混音器并显示给我音板概览。`
## 示例提示
尝试以下提示：
- "在网络上查找我的 X-Air 混音器。"
- "连接到 192.168.1.50 处的混音器。"
- "显示给我整个音板，包括名称、推子、静音和左右分配。"
- "将主唱的声音提高 2 dB。"
- "静音通道 5。"
- "给鼓手更多的声音在 2 号总线上。"
- "将通道 9 的增益设置为 24 dB。"
- "在确认后为通道 12 打开幻影电源。"
- "在主唱的 3 kHz 处降低 4 dB。"
- "显示给我踢鼓的门控和压缩器设置。"
- "关闭混响，我要讲话。"
- "恢复效果返回。"
- "进入休息音乐模式。"
- "将当前混音器状态保存为名为 Riverside Set 的快照。"
- "在演出前备份整个音台。"
- "监控音量计，检查 5 秒内是否有剪切。"
- "在 X-Air 地图中搜索 1 号总线的压缩器膝盖。"
- "使用混音站读取 `ch.0.mix.lvl`。"
## 演出宏
宏存储在 [presets/band_presets.json](presets/band_presets.json) 中。包含的默认宏涵盖：
| 宏 | 用途 |
| --- | --- |
| `line_check_safe` | 设置一个更安全的线路检查基准，而不触及幻影电源。 |
| `mute_all_inputs` | 静音通道 1-16。 |
| `unmute_all_inputs` | 取消静音通道 1-16。 |
| `break_music` | 静音乐队输入并开启辅助/USB 播放。 |
| `show_mode` | 从休息音乐返回到实时输入模式。 |
| `kill_fx` | 静音效果返回，以便在歌曲之间讲话。 |
| `restore_fx` | 取消静音效果返回。 |
使用以下提示运行它们：
```text
运行 break_music 宏。
运行 kill_fx，然后在我讲完话后恢复_fx。
保存一个新的宏，静音所有人声并让鼓声保持活跃。
```
## 安全注意事项
- 加载快照会立即更改整个混音器。请在演出期间确认后再执行此操作。
- 幻影电源可能会使扬声器爆裂并损坏某些连接的设备。请在切换前确认。
- 快照槽 64 可能被混音站用于总线密码数据。请避免覆盖它，除非您知道它是安全的。
- 一些 OSC 地图条目来自社区文档。请使用 `xair_node_dump` 或读取工具来验证不确定的参数与您的混音器。
- 备份写入 `backups/`，该目录被 Git 故意忽略。
## 开发
运行测试：
```bash
python3 -m pytest tests/
```
项目布局：
```text
xair_mcp/server.py MCP 工具和演出工作流助手
xair_mcp/osc_client.py 轻量级 OSC 客户端
xair_mcp/osc_map.py 可搜索的 X-Air OSC 地址映射
xair_mcp/conversions.py 人类单位到混音器线路值
xair_mcp/ms_client.py 混音站 API 客户端
presets/ 演出宏
tests/ 单元测试和模拟混音器测试
```
## 仓库
GitHub： [mlmil/Mix_Mind_v5.0](https://github.com/mlmil/Mix_Mind_v5.0)
