ableton-mind

Servidor MCP (Model Context Protocol) para Ableton Live. Expõe o Live Object Model completo para LLMs (Claude, Cursor, etc.) com knowledge base embutida de devices nativos, recipes musicais declarativas e verify loop integrado.

Status: Phase 0 — Spike em construção. API instável. Não use em produção.

📚 Documentação completa: pantani.github.io/ableton-mind

Arquitetura (3 camadas)

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

• src/ — servidor MCP em TypeScript. Tools, resources, prompts, cliente TCP.

• live/AbletonMind/ — Remote Script Python que sobe TCP server local na porta 9876.

• recipes/, src/knowledge/ — JSON estático (drum kits, basslines, schemas de devices).

Spec completa em PLAN.md. Contratos congelados em _workspace/contracts/.

Related MCP server: AbletonMCP Enhanced

Requisitos

• Node 20+

• Ableton Live 12 (prioritário; suporte Live 11 vem em Phase 1)

• macOS (primário; Windows em Phase 1 final)

Setup (dev)

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

Instalar o Remote Script (bridge Python)

Modo dev (symlink — edita no repo, Live recarrega):

node scripts/install-remote-script.mjs           # cria symlink
node scripts/install-remote-script.mjs --check   # só checa estado
node scripts/install-remote-script.mjs --copy    # cópia (CI/snapshot)

Modo manual:

• macOS: copie live/AbletonMind/ para ~/Music/Ableton/User Library/Remote Scripts/AbletonMind/

• Windows: copie para ~/Documents/Ableton/User Library/Remote Scripts/AbletonMind/

Ative em Live → Preferences → Link/Tempo/MIDI → Control Surface → AbletonMind.

Smoke test passo-a-passo: docs/smoke-test.md.

Rodar o servidor MCP

# stdio transport — apontar Claude Desktop / Cursor para este binário
npm run build
node dist/index.js

Variáveis de ambiente:

Estrutura do repo

src/
  index.ts            Entry point (MCP stdio transport)
  server/             Bootstrap MCP, registry de tools/resources/prompts
  live-client/        Cliente TCP NDJSON JSON-RPC
  tools/              Tools MCP por domínio (transport, track, clip, ...)
  utils/              Logger, helpers
  feedback/           Verify loop (Phase 1+)
tests/                vitest
live/AbletonMind/     Bridge Python (Remote Script)
_workspace/           Workspace do time multi-agente (contratos, ADRs, progresso)

Tools MCP disponíveis (Cycle 2)

Instalação 1-click (Claude Desktop)

Phase 7 entrega o .mcpb. Manifest base em dxt/manifest.json. Hoje só dev install.

Status do roadmap

Veja PLAN.md §12 e _workspace/PROGRESS.md.

31 tools MCP, 55 device schemas (~800 params indexados), 14 recipes em 7/7 categorias, verify loop 23/23, 7 eventos event.*.

Licença

MIT.