Distribuicao

Como o ableton-mind chega ao usuario final no release 0.1.1.

Estado do release

0.1.1 esta publicado no npm, GitHub Releases e MCP Registry oficial. A Glama tem uma listagem do servidor, mas o release hospedado da Glama e uma acao separada que precisa ser concluida na UI admin da Glama. O metadata da Smithery existe em smithery.yaml, mas a listagem hospedada pode atrasar por indexacao. Nao assuma que ghcr.io esta no ar sem checar o container registry.

A integracao com Ableton tem duas partes:

• MCP server: processo Node.js iniciado por Claude Desktop, Codex, Cursor, npm, Docker, Smithery ou outro cliente MCP.
• Remote Script: arquivos Python em live/AbletonMind/ que precisam ser instalados na User Library do Ableton Live e ativados nas preferencias do Live.

Canais hospedados conseguem rodar o MCP server, mas nao controlam um Ableton Live local sem acesso de rede ao bridge do Remote Script.

O bridge do Remote Script usa 127.0.0.1 por padrao e rejeita hosts que nao sejam loopback, exceto quando ABLETON_MIND_ALLOW_REMOTE=1 estiver definido. Use isso apenas atras de uma fronteira de rede/OS confiavel.

Instalacao via source

Use este caminho para desenvolvimento ou validacao de checkout local.

npm ci
npm run build
npm run install:remote-script
npm run test:bridge
npm start

O install de desenvolvimento usa symlink por padrao. Reabra o Control Surface no Live depois de editar para recarregar o script.

node scripts/install-remote-script.mjs --check
node scripts/install-remote-script.mjs --copy --force

npm

Instale pelo npm:

npm install -g ableton-mind
ableton-mind-install-remote-script
ableton-mind-doctor
ableton-mind

O pacote npm inclui:

• servidor compilado em dist/
• recipes e knowledge assets de runtime
• runtime do Remote Script em live/AbletonMind/, sem testes/cache
• ableton-mind-install-remote-script para instalar o Remote Script na User Library do Ableton
• arquivos de metadata/listing dos registries

Valide antes de publicar:

npm pack --dry-run --json
npm publish --dry-run

Claude Desktop .mcpb

Build local:

npm run build
npm run build:mcpb

Instale arrastando build/ableton-mind-0.1.1.mcpb para o Claude Desktop ou usando um instalador MCPB.

O bundle instala e roda o MCP server Node. Ele tambem inclui os arquivos do Remote Script e o installer para referencia, mas o Claude Desktop nao copia esses arquivos automaticamente para o Ableton Live. Instale o Remote Script separadamente pelo installer npm/source e depois ative no Live:

Live -> Preferences -> Link/Tempo/MIDI -> Control Surface -> AbletonMind.

Claude Code plugin marketplace

O catalogo do marketplace do Claude Code fica em .claude-plugin/marketplace.json. Ele lista um plugin leve ableton-mind em plugins/ableton-mind/, que inicia o MCP server publicado no npm com npx -y ableton-mind@0.1.1.

Valide o catalogo antes de compartilhar:

claude plugin validate .

Adicione o marketplace hospedado no GitHub e instale o plugin:

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

O plugin inicia apenas o MCP server Node. O usuario ainda precisa instalar o Remote Script e ativar AbletonMind nas preferencias do Live antes das tools MCP conseguirem controlar o Ableton Live.

MCP Registry

server.json e o manifesto do MCP Registry. Ele usa o nome:

io.github.Pantani/ableton-mind

Antes de submeter, confira a sincronizacao de versao:

node -e "const p=require('./package.json'),s=require('./server.json'); console.log(p.version, p.mcpName, s.name, s.version, s.packages[0].version)"

0.1.1 esta publicado como versao latest ativa no MCP Registry oficial. Rode mcp-publisher validate antes de publicar qualquer versao futura.

Smithery e Glama

smithery.yaml e glama.json sao metadata para canais de catalogo/hosting. A Glama tem listagem em:

https://glama.ai/mcp/servers/Pantani/ableton-mind

Uma listagem na Glama nao e a mesma coisa que um release na Glama. Para criar o release hospedado da Glama, use acesso de maintainer na Glama:

1. Claim o servidor pelo fluxo de score/listing da Glama, se ele ainda nao estiver claimed.
2. Abra a pagina admin do Dockerfile:

https://glama.ai/mcp/servers/Pantani/ableton-mind/admin/dockerfile

3. Configure build spec, argumentos do comando, schema de variaveis de ambiente e parametros placeholder.
4. Clique Deploy e aguarde o build test iniciar o MCP server com sucesso.
5. Clique Make Release, informe a versao e publique.

Valores sugeridos para o admin da Glama neste repo:

• Build steps:

["npm ci", "npm run build"]

• CMD arguments:

["node", "dist/index.js"]

• Variaveis de ambiente obrigatorias: nenhuma
• Variaveis de ambiente opcionais: ABLETON_MIND_HOST, ABLETON_MIND_PORT, ABLETON_MIND_LOG_LEVEL, ABLETON_MIND_TIMEOUT_MS

Use o guia da Glama para conferir os labels atuais da UI: https://glama.ai/blog/2026-03-15-how-to-make-a-release

smithery publish

Smithery/Glama ajudam com descoberta e hosting remoto do MCP server. Eles ainda precisam conseguir acessar o bridge local do Ableton do usuario. Para a maioria dos musicos, npm local ou .mcpb sao os caminhos principais.

Docker e ghcr.io

Build local:

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

Tags do workflow de release para versoes estaveis:

ghcr.io/pantani/ableton-mind:v0.1.1
ghcr.io/pantani/ableton-mind:latest

Prerelease tags mantem apenas a tag exata da versao e nao movem latest.

macOS / Linux

--network host deixa o container acessar 127.0.0.1:9876 no Linux. No Docker Desktop para macOS, host.docker.internal costuma ser mais confiavel:

docker run --rm -i \
  -e ABLETON_MIND_HOST=host.docker.internal \
  -e ABLETON_MIND_PORT=9876 \
  ableton-mind

Windows

A rede do Docker Desktop varia por backend. Prefira WSL2 quando possivel:

docker run --rm -i \
  -e ABLETON_MIND_HOST=host.docker.internal \
  -e ABLETON_MIND_PORT=9876 \
  ableton-mind

Se o container nao conseguir acessar o bridge, use npm ou .mcpb localmente.

Para um container ou MCP server hospedado que realmente precise acessar o Live a partir de outro host, defina ABLETON_MIND_HOST no lado do Remote Script e habilite explicitamente ABLETON_MIND_ALLOW_REMOTE=1. Nao exponha o bridge em rede nao confiavel.

Workflow de release

.github/workflows/release.yml roda em tags v*. Ele valida sync de versao dos manifestos, roda typecheck/lint/tests/build, gera o .mcpb, cria ou atualiza a GitHub Release, faz push de imagens ghcr.io e publica npm apenas quando isso estiver explicitamente habilitado.

Comportamento do npm:

• prerelease tags com - sao ignoradas
• tags estaveis publicam apenas com ABLETON_MIND_AUTO_NPM_PUBLISH=true e NPM_TOKEN
• publish manual continua sendo o padrao para 0.1.1

Secrets/variables de GitHub Actions:

Nome	Uso
NPM_TOKEN	publish npm opcional com provenance
ABLETON_MIND_AUTO_NPM_PUBLISH	variavel do repo que habilita publish npm automatico
GITHUB_TOKEN	GitHub Release e push para ghcr.io

Doctor CLI

ableton-mind-doctor

O doctor verifica Node, instalacao do Remote Script, acesso ao bridge, knowledge assets, recipes e imports dos primitivos MCP.