# 1. Clonar / copiar a pasta music21-mcp
cd music21-mcp

# 2. Criar ambiente virtual (recomendado)
python -m venv .venv
source .venv/bin/activate      # Linux/macOS
.venv\Scripts\activate         # Windows

# 3. Instalar dependências
pip install -r requirements.txt

python server.py

{
  "mcpServers": {
    "music21": {
      "command": "python",
      "args": ["/caminho/absoluto/para/music21-mcp/server.py"],
      "env": {}
    }
  }
}

music21 MCP (analyze_harmony)
    → detecta progressão do arquivo
    → passa para seu toolkit (comp_set_progression)
    → gera variação ou arranjo

music21 MCP (check_counterpoint)
    → aponta erros no MIDI gerado
    → seu toolkit (theory_voice_lead_sequence)
    → corrige o voice leading

music21-mcp/
├── server.py              # FastMCP — 8 tools registradas
├── models.py              # Pydantic schemas input/output
├── requirements.txt
├── analyzers/
│   ├── harmony.py         # Acordes + numerais romanos + cadências
│   ├── melody.py          # Contorno, âmbito, intervalos
│   ├── rhythm.py          # Tempo, densidade, síncope
│   ├── form.py            # Seções e forma musical
│   ├── counterpoint.py    # Erros de contraponto/voice-leading
│   ├── score_info.py      # Metadados e visão geral
│   └── motifs.py          # Padrões motívicos recorrentes
└── utils/
    └── loader.py          # Carregar arquivos + helpers music21

# analyze_key
{
  "file_path": "/home/user/bach_prelude.mid",
  "response_format": "json"
}

# analyze_harmony com recorte de compasses
{
  "file_path": "/home/user/sonata.xml",
  "measures": [1, 16],
  "response_format": "markdown"
}

# analyze_motifs customizado
{
  "file_path": "/home/user/symphony.mid",
  "motif_length": 5,
  "min_occurrences": 3
}