# Scythe MCP ā REAPER Integration
AI-powered music composition and control for REAPER DAW via Model Context Protocol.
## šµ Features
- **OSC Control**: Transport, tempo, volume, pan, mute/solo
- **MIDI Generation**: Create tracks, items, and notes programmatically
- **execute_lua**: Full REAPER control via ReaScript
- **Music Theory**: Scales, chords, progressions, rhythm patterns
## šø Demo
*5 tracks created via MCP: Drums, Bass, Keys, Melody, FX ā each with MIDI patterns and colors*
## š Quick Start
### 1. Install Python dependencies
```bash
cd d:/tareas/experiment_cubase
uv sync
```
### 2. Configure REAPER OSC
1. **Preferences** ā **Control/OSC/Web** ā **Add**
2. Select **OSC (Open Sound Control)**
3. Configure:
- Mode: **Local port**
- Port: **8000**
- Local IP: **192.168.0.3** (your local IP)
### 3. Load the Lua script
1. Copy `scythe_mcp/reascript/scythe_poller.lua` to REAPER Scripts
2. **Actions** ā **Load ReaScript** ā Run
### 4. Add to MCP config
```json
{
"mcpServers": {
"scythe": {
"command": "uv",
"args": ["run", "scythe-mcp"],
"cwd": "d:/tareas/experiment_cubase"
}
}
}
```
## š ļø Available Tools
| Tool | Description |
|------|-------------|
| `play`, `stop`, `record` | Transport control |
| `set_tempo(bpm)` | Change project tempo |
| `create_track(name)` | Create new track |
| `set_track_volume(track, vol)` | Set volume (0-1) |
| `mute_track`, `solo_track` | Mute/solo toggle |
| `execute_lua(code)` | Run any Lua in REAPER |
## š Project Structure
```
scythe_mcp/
āāā server/
ā āāā main.py # MCP server with tools
ā āāā reaper_bridge.py # OSC + file-based commands
āāā reascript/
ā āāā scythe_poller.lua # REAPER Lua client
ā āāā install.md # Setup guide
āāā music_theory/
ā āāā scales.py # 15+ scales and modes
ā āāā chords.py # Chord construction
ā āāā progressions.py # Genre-specific progressions
ā āāā rhythm.py # Time signatures, swing
āāā generators/
āāā drums.py # Drum patterns
āāā basslines.py # Bass generators
āāā melodies.py # Melody generators
```
## š¹ Example: Create a Lo-fi Beat
Ask the AI:
> "Create a lo-fi track at 85 BPM with jazzy chords and a dreamy melody"
What gets created:
- 5 tracks (Drums, Bass, Keys, Melody, FX) with colors
- Chord progression: Cmaj7 ā Am7 ā Fmaj7 ā G7
- Melody notes on the Melody track
- ReaSynth loaded on each track
## š License
MIT
