Instalação

Os caminhos mais rapidos agora sao npm global, o .mcpb da GitHub Release ou o marketplace de plugin do Claude Code. Use instalacao via source para desenvolver o repo ou testar mudancas locais.

1. Instalacao via source

git clone https://github.com/Pantani/ableton-mind.git
cd ableton-mind
npm ci
npm run build
npm run install:remote-script

Depois ative AbletonMind no Live:

Live -> Preferences -> Link, Tempo & MIDI -> Control Surface -> AbletonMind.

2. Config do cliente MCP

Para checkout local, aponte o cliente para dist/index.js:

{
  "mcpServers": {
    "ableton-mind": {
      "command": "node",
      "args": ["/absolute/path/to/ableton-mind/dist/index.js"]
    }
  }
}

Use o path absoluto da sua maquina.

3. Claude Desktop .mcpb

Baixe ableton-mind-0.1.1.mcpb na GitHub Release v0.1.1 e arraste para o Claude Desktop.

O repo tambem consegue montar bundle local:

npm run build:dxt

Arraste o .mcpb gerado para o Claude Desktop.

4. Claude Code plugin marketplace

claude plugin marketplace add Pantani/ableton-mind
claude plugin install ableton-mind@ableton-mind

O plugin inicia npx -y ableton-mind@0.1.1. Instale e ative o Remote Script no Live antes de usar as tools MCP.

5. npm global

npm install -g ableton-mind
ableton-mind
ableton-mind-doctor

Estado atual do registry: ableton-mind@0.1.1 esta publicado no npm.

6. Docker

Build local:

docker build -t ableton-mind .
docker run --rm -i --network host ableton-mind

No macOS/Windows com Docker Desktop, talvez seja necessario usar host.docker.internal como host da bridge:

docker run --rm -it \
  -e ABLETON_MIND_HOST=host.docker.internal \
  ableton-mind

Util para CI e sandboxes; para uso interativo no desktop, source ou .mcpb tendem a ser mais simples.

7. Smithery

smithery.yaml existe para o caminho de listagem. A indexacao hospedada da Smithery pode atrasar em relacao ao metadata do repo.

Detalhes completos

A página Distribuição cobre cada canal em profundidade, incluindo CI, release pipeline e gates de publicação.