内容
# qa-ableton-mcp
通过AI编码代理驱动 **Ableton Live**，使用[模型上下文协议](https://modelcontextprotocol.io/)和[Ableton扩展SDK](https://ableton.github.io/extensions-sdk/)。一个仓库包含两个软件包：
| 软件包 | 路径 | 角色 |
|---------|------|------|
| `@quantumaudio/ableton-mcp` | [`packages/server`](packages/server) | MCP标准输入输出服务器（工具、技能、模式） |
| `@quantumaudio/ableton-mcp-kernel` | [`packages/kernel`](packages/kernel) | Live内扩展 + WebSocket（`:17890`） |
许可证：[Apache-2.0](LICENSE)。
> **状态：** v0.1 原型 — API和技能快速演化。
## 为什么存在
与固定工具的Ableton MCP不同，该堆栈公开了 **`ableton_run_code`**：代理在Live内执行TypeScript以应对扩展SDK，因此新操作不需要服务器端更新。Perception使用带有可选[@quantumaudio/music-ir](https://github.com/QaAudio/qa-music-ir)文本表示的键入**扫描/读取**工具。
## 快速入门
**前提条件：** Ableton Live 12.4+ 测试版，启用**开发者模式**，Node ≥ 24，Ableton扩展SDK tgz（参见 [packages/kernel/SDK.md](packages/kernel/SDK.md)）。
```bash
git clone https://github.com/QaAudio/qa-ableton-mcp.git
cd qa-ableton-mcp
npm install
# 在packages/kernel中安装@ableton-extensions/sdk + cli（参见SDK.md）
npm run build
```
**终端 1 — kernel 在 Live中：**
```bash
npm run start -w @quantumaudio/ableton-mcp-kernel
```
**终端 2 — MCP（或配置您的代理）：**
```bash
node packages/server/dist/index.js
```
**光标** — 添加到 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"qa-ableton-mcp": {
"command": "node",
"args": ["packages/server/dist/index.js"]
}
}
}
```
可选：`node packages/server/scripts/register-cursor.mjs` 从仓库根目录（在QuantumAudio monorepo内运行时写入项目MCP配置 + 技能链接）。
## 文档
- **用户指南和工具参考：** [packages/server/README.md](packages/server/README.md)
- **内核/扩展开发：** [packages/kernel/README.md](packages/kernel/README.md)
- **代理约定：** [AGENTS.md](AGENTS.md)
## 生态系统
| 仓库 | npm | 目的 |
|------|-----|---------|
| [qa-ableton-mcp-schemas](https://github.com/QaAudio/qa-ableton-mcp-schemas) | `@quantumaudio/ableton-mcp-schemas` | Zod线路模式 |
| [qa-music-ir](https://github.com/QaAudio/qa-music-ir) | `@quantumaudio/music-ir` | 符号/鼓点网格/结构IR |
| [qa-knowledge](https://github.com/QaAudio/qa-knowledge) | `@quantumaudio/qa-knowledge` | SDK + 技能语料库 |
| [qa-knowledge-mcp](https://github.com/QaAudio/qa-knowledge-mcp) | `@quantumaudio/knowledge-mcp` | 语义文档搜索MCP |
在您的代理中配对 **qa-ableton-mcp** + **qa-knowledge-mcp**：实时控制 + SDK查找（`search_knowledge`）。
## 工作区命令
从仓库根目录：
```bash
npm run typecheck # 两个软件包
npm run build # 两个软件包
npm run test # 服务器单元测试（内核测试通过monorepo中的tsx）
```
## 贡献
欢迎在 [QaAudio/qa-ableton-mcp](https://github.com/QaAudio/qa-ableton-mcp) 上提交PR。与 [qa-ableton-mcp-schemas](https://github.com/QaAudio/qa-ableton-mcp-schemas) 协调模式更改。参见 [AGENTS.md](AGENTS.md) 和 `.cursor/skills/security-guidelines/`。
