# 1. Enumerate connected MIDI devices
list_midi_devices()
# Returns device information for inputs and outputs

# 2. Record MIDI performance
record_midi_performance(device_index=0, duration_seconds=30)
# Captures live performance to timestamped MIDI file

# 3. AI-assisted content generation
midi_to_ai_seed("recording.mid", expansion_style="full_production")
# Analyzes MIDI and generates structured content for AI processing

# 4. Generate complete track with AI vocals
songgen_to_deck(lyrics, genre="Electronic", tempo=128, deck=1)
# Produces professional vocal and instrumental tracks

User: "Create a complete electronic track about cyberpunk cities"

AI: "I'll orchestrate a full production pipeline for 'cyberpunk neon city' theme.

Starting autonomous workflow:
1. Analyzing theme and generating structured lyrics
2. Creating vocal performance with AI synthesis
3. Generating electronic backing tracks and stems
4. Mixing and mastering for professional sound
5. Loading final track to VirtualDJ deck

Progress: Lyrics generated → Vocals rendered → Stems produced → Mix complete → DJ integration finished

Track 'Neon Shadows' is ready on Deck 1. Would you like me to generate variations or start a new track?"

User: "Help me make this mix more energetic"

AI: "I can analyze your current production and suggest improvements. Looking at the track structure...

Current analysis:
- BPM: 128, Energy level: Medium
- Frequency balance: Mids dominant, highs attenuated
- Dynamic range: Compressed, could use more punch

Suggestions:
1. Increase high-frequency EQ on percussion stems (+3dB at 8kHz)
2. Add sidechain compression on bass to create rhythmic pumping
3. Boost attack on kick drum samples for more impact
4. Layer in additional percussion elements for complexity

Would you like me to implement these changes automatically, or would you prefer to adjust specific elements?"

User: "I need a 12-track concept album about space exploration"

AI: "I'll orchestrate a complete album production using SEP-1577 sampling across all available tools.

Planning autonomous workflow:
- Album structure: 12 tracks with cohesive theme
- Parallel track generation using SongGeneration-MCP
- Consistent mastering across all tracks via Reaper-MCP
- Automated organization in Plex-MCP library
- Quality analysis and refinement iterations

Estimated completion: 45 minutes
Track list generated → Production pipeline started → Quality checks running

First track 'Launch Sequence' complete. Continuing with remaining tracks..."

ai_dj_set("progressive house summer", num_tracks=6)
# Generates themed track collection with harmonic mixing analysis

# 1. Record MIDI performance
record_midi_performance(0, 30)

# 2. AI content analysis and generation
midi_to_ai_seed("recording.mid", "full_production")

# 3. Complete track production
songgen_to_deck(lyrics, genre="Electronic", tempo=128, deck=1)

User: "Produce a full album about space exploration"

AI: "I'll manage the complete album production workflow using autonomous orchestration.

Album Concept: 'Cosmic Journey' - 10 tracks exploring space themes

Workflow initiated:
- Generating track concepts and lyrics for each song
- Parallel production using SongGeneration LeVo AI
- Consistent mastering and mixing across all tracks
- Automatic organization into album structure
- Quality analysis and refinement

Status: Track 1/10 'Stellar Winds' → Complete
        Track 2/10 'Zero Gravity' → Rendering vocals...

Album completion: ~30 minutes remaining
Would you like me to adjust the production style or add specific elements?"

User: "Start a 2-hour ambient electronic stream on Twitch"

AI: "I'll set up autonomous live streaming with continuous AI-generated content.

Streaming Configuration:
- Theme: Ambient electronic atmospheres
- Duration: 2 hours (120 minutes)
- Platform: Twitch integration via OBS-MCP
- Content strategy: Progressive evolution with smooth transitions

Setup initiated:
- OBS streaming configuration established
- Initial track generation started (3 tracks pre-buffered)
- VirtualDJ automix sequence programmed
- Engagement monitoring activated

Stream Status: Pre-roll tracks loaded → Going live in 30 seconds
Content pipeline: Track generation every 12-15 minutes
Quality monitoring: Active with automatic adjustments

Stream is now live! I'll continue generating fresh content throughout."

uvx ai-producer-hub

"mcpServers": {
  "ai-producer-hub": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/ai-producer-hub", "run", "ai-producer-hub"]
  }
}

uvx ai-producer-hub

"mcpServers": {
  "ai-producer-hub": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/ai-producer-hub", "run", "ai-producer-hub"]
  }
}

# Install component servers (adjust paths as needed)
uv pip install -e /path/to/virtualdj-mcp
uv pip install -e /path/to/plex-mcp
uv pip install -e /path/to/songgeneration-mcp
uv pip install -e /path/to/reaper-mcp
uv pip install -e /path/to/obs-mcp

{
  "mcpServers": {
    "ai-producer-hub": {
      "command": "python",
      "args": ["-m", "ai_producer_hub"],
      "cwd": "/path/to/ai-producer-hub"
    }
  }
}

pip install ai-producer-hub[ai]

pip install ai-producer-hub[dev]

pip install ai-producer-hub[docs]

User: "Check my MIDI devices and record a 30-second performance"

AI: "Found MIDI devices: MPK mini 3 (input), Microsoft GS (output)

Starting 30-second recording... Play your performance now.

Recording complete! Saved as 'midi_performance_20241201_143022.mid'

Analyzing MIDI content for AI processing..."

User: "Create a complete electronic track about cyberpunk cities"

AI: "Initiating autonomous production pipeline for 'cyberpunk city night' theme.

Production stages:
1. Theme analysis and lyric structure generation
2. Vocal synthesis using SongGeneration LeVo AI
3. Electronic backing track composition
4. Professional mixing and mastering
5. VirtualDJ deck integration

Status: Lyrics generated → Vocals rendering → Stems produced → Mix complete

Track 'Neon Metropolis' loaded to Deck 1. BPM: 130, Key: F minor.
Would you like me to generate variations or start mixing?"

User: "Make me a 12-track album about urban exploration"

AI: "Planning autonomous album production for 'Urban Exploration' concept.

Album structure:
- Track 1: Street Lights - Opening ambient
- Track 2: Concrete Dreams - Driving rhythm
- Track 3: Hidden Alleys - Atmospheric interlude
- ...continuing through 12 tracks

Starting parallel production pipeline using SEP-1577 sampling:
- SongGeneration-MCP: Vocal and instrumental generation
- Reaper-MCP: Mastering and final production
- Plex-MCP: Library organization

Progress: 3/12 tracks complete. Estimated completion: 42 minutes.

First tracks available in your Plex music library."

User: "The mix needs more energy in the drop sections"

AI: "Analyzing your current production mix...

Current assessment:
- Energy profile: Moderate, could benefit from increased dynamics
- Frequency response: Mids-heavy, highs attenuated
- Rhythmic elements: Steady but lacking impact

Recommendations:
1. Apply upward compression to percussion bus (+4dB threshold, 3:1 ratio)
2. Add high-frequency boost to cymbals (2-3dB at 12kHz)
3. Implement sidechain ducking on pads during drops
4. Layer additional percussion hits for build-up tension

I can implement these changes automatically, or guide you through manual adjustments. Which approach would you prefer?"

ai-producer-hub/
├── AI Integration Layer
│   ├── ai_integration.py      # SEP-1577 sampling + conversational AI
│   └── Autonomous workflows   # AI-managed production pipelines
│
├── Local MIDI Tools (8 tools)
│   ├── Device enumeration     # python-rtmidi + mido
│   ├── Performance capture    # Live recording and processing
│   ├── Hardware control       # MIDI I/O and monitoring
│   └── AI content analysis    # MIDI-to-content conversion
│
├── Component MCP Servers
│   ├── /dj/*      - VirtualDJ-MCP (61 tools) - Professional mixing
│   ├── /plex/*    - Plex-MCP (15 tools) - Media library management
│   ├── /songgen/* - SongGeneration-MCP (7 tools) - AI vocal/instrumental generation
│   ├── /reaper/*  - Reaper-MCP (25 tools) - DAW and mastering
│   └── /obs/*     - OBS-MCP (20 tools) - Live streaming
│
└── Cross-Server Orchestration
    ├── ai_produce_track()     - Autonomous track production
    ├── ai_orchestrate_production() - SEP-1577 sampling workflows
    ├── ai_collaborate_workflow() - Conversational AI assistance
    ├── ai_stream_production() - Automated live streaming
    └── ai_analyze_production() - AI-powered quality assessment

# Install development dependencies
uv pip install -e .[dev,ai,docs]

# Run tests
pytest tests/ -v --cov=src

# Lint and format
ruff check . --fix
ruff format .

# Type checking
mypy src/