ableton-mind — Ableton Live MCP server

ableton-mind

面向 Ableton Live 的权威 MCP（Model Context Protocol）服务。向大模型（Claude、Cursor 等）开放完整的 Live Object Model，内置原生设备知识库、声明式音乐配方、集成验证循环和响应式监听器。

状态：alpha / v0.1.1 已发布——已通过针对 macOS 上 Ableton Live 12.4.1 的核心冒烟测试，软件包验证也已通过。npm、GitHub Release .mcpb 和 MCP Registry 均已上线。Glama 已收录，但其托管版本/部署需要通过 Glama 管理后台构建流程单独发布；Smithery 元数据已提供，索引可能有所延迟。API 尚不稳定，请勿用于生产环境。

Phase 8 状态：第 1 个切片提供只读的 Max for Live/插件内省，以及 Link/远程状态发现。更深入的 M4L 控制、VST3 sidecar、远程 DAW 集成和移动端伴侣应用仍在待办中。

📚 完整文档： pantani.github.io/ableton-mind/

架构（3 层）

Claude/Cursor ──MCP/stdio──▶ ableton-mind (TS, Node 20+) ──TCP NDJSON JSON-RPC──▶ Remote Script (Python, inside Live)

• src/——TypeScript MCP 服务。工具、资源、提示词、TCP 客户端、配方运行器、知识库加载器。
• live/AbletonMind/——Python Remote Script。运行在端口 9876 上的 TCP 服务，将 JSON-RPC 分派给 LiveAPI。
• recipes/、src/knowledge/——内嵌 JSON（鼓组、贝斯线、机架、设备架构）。

完整规格见 PLAN.md。冻结的契约见 _workspace/contracts/。

与现有 MCP/OSC 服务的亮点对比

能力	ahujasid/ableton-mcp	AbletonOSC + MCP wrapper	ableton-mind
MCP 工具	22	~30	36
LOM 覆盖率	~10%	~95%	~100%
知识库	无	无	55 种设备、音阶、鼓组
配方	无	无	7 类共 14 个
验证循环	无	无	有，已集成（session_snapshot/diff）
渲染预览	无	无	有（当前支持快照，计划支持混音导出）
响应式监听器 → MCP 通知	无	部分支持（OSC）	有（7 个事件已上线）
事务（单步撤销）	无	无	有
自动化包络	无	部分支持	完整支持（线性 / 保持）
Push 1/2/3 控制	无	无	有（音垫/按钮/模式 LED）
Docker	无	无	有
.mcpb 一键安装	无	无	有
Doctor 命令行工具	无	无	有

要求

• Node 20+
• Ableton Live 12（优先；支持 Live 11）
• macOS（主要平台），Windows（Phase 1 最终阶段）

安装（从源码安装）

npm install
npm run typecheck
npm run lint
npm run test
npm run build

安装 Remote Script（Python 桥接程序）

开发模式（符号链接）：

node scripts/install-remote-script.mjs           # creates symlink
node scripts/install-remote-script.mjs --check   # status only
node scripts/install-remote-script.mjs --copy    # full copy (CI / snapshot)

手动安装：

• **macOS：**将 live/AbletonMind/ 复制到 ~/Music/Ableton/User Library/Remote Scripts/AbletonMind/
• **Windows：**复制到 ~/Documents/Ableton/User Library/Remote Scripts/AbletonMind/

然后选择 Live → Preferences → Link/Tempo/MIDI → Control Surface → AbletonMind。

冒烟测试：docs/smoke-test.md。

运行 MCP 服务

npm run build
node dist/index.js

环境变量：

变量	默认值
ABLETON_MIND_HOST	127.0.0.1	Python 桥接程序主机
ABLETON_MIND_PORT	9876	桥接 TCP 端口
ABLETON_MIND_TIMEOUT_MS	5000	每次请求超时时间
ABLETON_MIND_MAX_FRAME_BYTES	1048576	接收的 JSON-RPC 帧最大大小
ABLETON_MIND_MAX_PENDING_REQUESTS	128	最大并发 JSON-RPC 调用数
ABLETON_MIND_LOG_LEVEL	info	debug | info | warn | error

本地副驾驶

使用本地 LLM 运行同一组 Ableton 工具的精选子集：

ollama pull qwen2.5:3b      # optional; the UI can pull too
node dist/index.js chat     # opens http://127.0.0.1:4142
node dist/index.js ask "What is in this set?"

默认层级为只读（safe）。使用 --write 进行简单更改，或使用 --creative 加载配方／浏览器。

变量	默认值
ABLETON_MIND_LLM_BASE_URL	http://127.0.0.1:11434/v1	兼容 OpenAI 的端点
ABLETON_MIND_LLM_MODEL	qwen2.5:3b	本地模型 ID
ABLETON_MIND_LLM_TIER	safe	safe | standard | creative
ABLETON_MIND_CHAT_PORT	4142	浏览器 UI 端口

参见本地副驾驶。

Doctor 命令行工具

npx ableton-mind-doctor

检查 Node 版本、Remote Script 安装、桥接端口、知识库完整性和配方。

分发

• npm： npm install -g ableton-mind。
• Claude Code 插件市场： claude plugin marketplace add Pantani/ableton-mind，然后运行 claude plugin install ableton-mind@ableton-mind。
• Claude Desktop 一键安装： 从 v0.1.1 GitHub Release 下载 ableton-mind-0.1.1.mcpb。
• MCP Registry： io.github.Pantani/ableton-mind 已在官方注册表中启用。
• Glama： 已列于 glama.ai/mcp/servers/Pantani/ableton-mind；托管版本与 GitHub Release 分开，仍需通过 Glama 管理员部署和 Make Release 流程发布。
• 源码： npm ci && npm run build && npm run install:remote-script。
• Docker： docker build -t ableton-mind . && docker run --rm -i --network host ableton-mind。
• Smithery： smithery.yaml 已准备好用于上架／索引。

路线图

参见 PLAN.md §12 和 _workspace/PROGRESS.md。

阶段	状态
0 — 试验	✅ 真实冒烟测试通过
1 — ahujasid 对等功能	✅ 22/22
2 — 监听器	✅ 7 个事件
3 — 知识库	✅ 55 个设备
4 — 自动化包络	✅
5 — 预览／验证	✅ 快照 + 差异（计划支持反弹导出）
6 — 推送	✅ 打击垫／按钮／模式 LED
7 — 分发	✅ DXT/Docker/Smithery/CI/发布已就绪
8 — 长尾功能	🔵 已交付第 1 部分：只读 M4L／插件内省 + Link／远程状态发现；更深入的 M4L/VST3/远程 DAW/移动端工作尚待开展

许可证

MIT。