Metadata-Version: 2.4
Name: lp12magic
Version: 0.1.0
Summary: LP12Magic — MCP server for Logic Pro 12 with instrument intelligence for UJAM, Kontakt, AAS, and IK Multimedia
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: jsonschema>=4.0.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: mido>=1.3.0
Requires-Dist: music21>=9.0.0
Requires-Dist: pynput>=1.7.0
Requires-Dist: python-rtmidi>=1.5.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# LP12Magic

**MCP server for Logic Pro 12** with deep instrument intelligence.

Create, arrange, and refine Logic Pro sessions through natural language. The first MCP server with awareness of 163 third-party instruments across UJAM, Native Instruments Kontakt, AAS, IK Multimedia, Mixed In Key, and Logic's own Session Players.

## What It Does

- **Natural language session creation**: *"16-bar funk in E minor at 110 BPM"* generates tracks, chords, regions
- **Chord Track intelligence**: Generates voicings, imports MIDI, auto-populates Logic's Chord Track via Chord ID
- **Session Player integration**: Creates and places AI-driven bass/keyboard/drummer regions that follow chord changes
- **Instrument database**: 163 instruments with verified MIDI maps, keyswitches, CC parameters, and phrase triggers
- **Iterative refinement**: Mute/solo, change chords, adjust volumes, duplicate/move regions mid-session
- **44 MCP tools**: Transport, tracks, MIDI, chords, arrangement, Session Players, phrase instruments, export

## Quick Start

```bash
pip install -e .
```

Configure your MCP client (Claude Desktop or Claude Code) to use `lp12magic` as the server command. See [Setup Guide](docs/SETUP_GUIDE.md) for IAC Driver and Logic Pro configuration.

## Instrument Coverage

| Vendor | Count | Verified | Types |
|--------|-------|----------|-------|
| UJAM | 44 | All | Drums, Bass, Guitar, Keys, Strings, Brass, Woodwind, Beatmaker |
| NI Kontakt | 74 | 22 | Session Bassist/Guitarist/Horns/Strings, Piano, Orchestral, Drums |
| NI Standalone | 8 | 0 | FM8, Massive, Massive X, Monark, etc. |
| AAS | 7 | All | Chromaphone, Strum GS-2, Lounge Lizard, String Studio, etc. |
| IK Multimedia | 8 | All | MODO Bass/Drum, SampleTank, Syntronik, Hammond B-3X, etc. |
| Mixed In Key | 14 | All | Captain Beat/Chords/Deep/Melody/Play, Pilot series |
| Logic Native | 8 | All | Alchemy, Drummer, Session Players (Bass/Keyboard/Synth) |

## Requirements

- macOS (AppleScript + Quartz UI automation)
- Logic Pro 12
- Python 3.11+
- MCP-compatible client

## License

MIT
