查看“︁Ardour/Using-control-surfaces/MCP/HTTP”︁的源代码

'''MCP HTTP''' control surface 是一个实验性 HTTP server，让支持 MCP（Model Context Protocol，模型上下文协议，不是 Mackie Control Protocol）的 AI 助手可以检查和操作正在运行的 Ardour session。

* 在 *Preferences* → *Control Surfaces* 启用 *MCPHttp* 并打开设置对话框
* 默认 endpoint：`http://127.0.0.1:4820/mcp`（端口 4820），默认监听本机所有接口；若开启监听所有网络接口，会把 Ardour 控制暴露给网络上的设备，请只在受信任的网络启用
* 工具范围：session 信息/保存/undo/snapshot/mixer scene、transport（locate/play/stop/loop/punch）、track 与 bus 增删选改（fader、pan、mute、solo、record safe）、send（含 pre/post-fader）、plugin（发现、插入、bypass、参数）、marker 与 range、region（移动、复制、resize、split、normalize）、MIDI（含 JSON 批量导入/导出）
* 客户端配置示例：Codex CLI（`codex mcp add`）、Gemini CLI、Claude Desktop（经 `mcp-remote`）、Copilot CLI（`/mcp add`）
* 批量音符请优先用 MIDI JSON 工具；JSON 时间相对于目标 region 起点（`bar: 1` / `b: 1` 为 region 第一拍），`b` 可取小数，鼓模式可省略 note-off
* 破坏性操作（删除 marker、移动 region、normalize 等）之前建议先 snapshot
* 实验性：功能可能随反馈变化；selected-region targeting 尚未实现；工具响应同时带结构化 MCP 数据与 JSON 文本 fallback

== 相关页面 ==
* [[Ardour/Using-control-surfaces|Using Control Surfaces]]
* [[Ardour/Using-control-surfaces/WebSockets Server|WebSockets Server]]